原生移动开发 / 系统课时
Android 项目目录结构
Android 项目目录结构
本节解决“一个 Android 工程里每个目录到底负责什么”的问题。读完后,你能从项目根目录一路定位到 app 模块、运行时代码、资源与测试代码,并知道哪些文件应修改、哪些生成目录不应手工维护。
学习目标
- 区分项目级配置、模块级配置与源码目录的职责。
- 识别
src/main、src/test、src/androidTest的使用边界。 - 能从目录结构快速定位 Manifest、代码、资源和构建产物。
先看项目根目录和模块边界
Android Studio 常见工程以“项目 + 模块”组织。根目录负责声明有哪些模块以及全局 Gradle 行为,真正生成 APK 或 AAB 的通常是 app 应用模块。一个项目也可以继续添加 library、feature 等模块,因此不要把“项目”与“app 模块”当成同一个层级。
根目录常见文件包括 settings.gradle.kts、项目级 build.gradle.kts、gradle.properties、Gradle Wrapper 文件和 local.properties。其中 settings.gradle.kts 决定参与构建的模块;local.properties 常保存本机 SDK 路径,属于机器相关配置,通常不应作为团队共享配置修改。

读懂 app/src/main
app/src/main 是应用默认 source set。AndroidManifest.xml 声明应用组件、权限和启动入口;java 或 kotlin 目录保存 Kotlin/Java 源码;res 保存会被 Android 资源系统编译的布局、字符串、图片、主题等资源。
资源目录不是普通文件夹集合。像 res/layout、res/drawable、res/values 的名称具有约定含义,构建后会通过生成的 R 类访问。相反,app/build 是 Gradle 生成目录,包含中间产物和打包结果,不应把业务源码放进去,也不应手工维护其中内容。
区分正式代码与测试代码
src/main 参与正式应用构建;src/test 默认用于运行在开发机 JVM 上的本地单元测试,适合纯 Kotlin/Java 逻辑;src/androidTest 用于在设备或模拟器上执行 instrumentation 测试,可以访问 Android Framework。
如果使用 build type 或 product flavor,还可能出现 src/debug、src/release 或 src/<flavor>。这些目录与 main 按构建变体合并,因此同名资源和 Manifest 配置可能被特定变体覆盖。排查“代码明明改了却没生效”时,要先确认当前构建的是哪个变体。
用命令核对实际目录
在项目根目录执行下面的命令可以快速查看 main source set 的一级内容。示例适用于 macOS、Linux 或 WSL。
find app/src/main -maxdepth 1 -mindepth 1 -print | sort预期输出
app/src/main/AndroidManifest.xml
app/src/main/java
app/src/main/res不同模板可能还会出现 assets、cpp 等目录,实际结果可以不同;关键是确认 Manifest、源码和资源都位于当前模块的 src/main 下。
容易混淆的边界
看到 Gradle 文件时先判断它位于项目根目录还是模块目录:前者更偏向插件版本、仓库或全局约束,app/build.gradle.kts 则定义 Android 插件、SDK 版本、依赖和应用构建参数。看到测试文件时再判断它需要不需要 Android 运行环境,从而选择 test 还是 androidTest。
掌握这套层级后,定位文件可以遵循固定顺序:先找模块,再找 source set,最后找代码、资源或 Manifest。这样即使工程增加多个模块和构建变体,也不会因为目录数量变多而失去方向。