打开 Android Studio 项目第一层就是项目根目录很多人只会点开 app 模块写代码完全不知道外层文件作用下面按「必懂核心」「构建配置」「Git忽略」「缓存日志」分类讲清楚同时附上 app 模块内部关键文件。一、根目录第一层整体结构预览项目名/ ├── .gradle/ Gradle 构建缓存目录不用管 ├── .idea/ Android Studio 配置文件IDE专属 ├── app/ 主应用模块99%业务代码在这里 ├── build/ 整个项目构建输出产物可删除 ├── gradle/ Gradle Wrapper 包装脚本控制Gradle版本 ├── .gitignore Git忽略文件配置 ├── build.gradle.kts 【全局项目构建配置根级】 ├── gradle.properties 全局Gradle属性、开关、AndroidX配置 ├── gradlew / gradlew.bat 跨平台Gradle执行脚本Mac/Windows ├── local.properties 本地SDK路径、NDK路径每个人电脑不一样 ├── settings.gradle.kts 项目模块注册入口告诉Gradle有哪些子模块二、逐个文件详细解释1. settings.gradle.kts 【超级重要】作用告诉 Gradle 当前项目包含哪些子模块是项目入口清单默认内容pluginManagement{repositories{google()mavenCentral()}}dependencyResolutionManagement{repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)repositories{google()mavenCentral()}}// 注册app模块include(:app)新增 library 组件化模块必须在这里include(:xxx)否则AS识别不到里面同时配置了依赖仓库地址google、mavenCentral。2. 根目录 build.gradle.kts项目全局构建只做一件事全局声明 AGP、Kotlin 插件版本所有子模块共用典型内容plugins{id(com.android.application)version9.3.0applyfalseid(com.android.library)version9.3.0applyfalseid(org.jetbrains.kotlin.android)version2.0.0applyfalse}apply false只定义版本不在根目录直接运行插件app 模块只需要直接引用插件不用重复写版本统一版本避免冲突。3. gradle.properties 全局配置文件高频修改整个项目全局开关、常量、编译参数都写这里常用配置# 开启AndroidX、Jetifier兼容新项目必开 android.useAndroidXtrue android.enableJetifiertrue # JVM内存、并行构建 org.gradle.jvmargs-Xmx4g org.gradle.paralleltrue # 全局版本常量子模块直接引用 minSdkVersion24 targetSdkVersion36 compileSdkVersion36用途统一 minSdk、compileSdk改一处全部模块生效开启构建加速、AndroidX、R类优化等开关。4. local.properties 【本地环境配置禁止提交Git】记录当前电脑本地环境路径每台电脑自动生成内容不一样示例sdk.dirC\:\\Users\\xxx\\AppData\\Local\\Android\\Sdk ndk.dirxxx作用告诉项目本机 Android SDK 安装在哪换电脑、换SDK路径会自动重新生成不要手动修改不要上传代码仓库。5. gradle 文件夹控制Gradle版本核心gradle/wrapper/ └── gradle-wrapper.properties唯一核心文件gradle-wrapper.propertiesdistributionUrlhttps\://services.gradle.org/distributions/gradle-8.10-all.zip决定当前项目用哪个 Gradle 版本也就是你上一问关心的多版本管理的源头。6. gradlew / gradlew.bat 脚本文件gradlewMac / Linux 终端执行构建脚本gradlew.batWindows CMD/PowerShell 执行脚本使用示例# Mac打包正式包./gradlew assembleRelease# Windowsgradlew.bat assembleRelease强制建议永远用这两个脚本构建不要用系统全局gradle避免版本错乱7. .gitignore Git忽略文件配置哪些文件不需要提交到代码仓库模板内容# 构建产物 /build/ /.gradle/ # 本地环境文件 local.properties # IDE配置 .idea/caches # 日志、APK、签名文件 *.apk *.log作用防止每个人IDE缓存、编译产物、本地路径冲突提交上去。8. .idea 文件夹Android Studio IDE配置存放代码格式化规则、运行配置、索引、模块配置、版本控制记录只给AS用Gradle构建不依赖可以加入git提交团队统一代码风格也可以忽略不影响项目运行。9. .gradle 文件夹Gradle 构建过程缓存、依赖缓存、任务缓存可以随时删除下次构建自动重新生成体积很大定期删除可清理C盘空间。10. 根目录 build 文件夹整个项目编译中间产物、依赖解压包完全可删清理构建异常第一操作删除所有build文件夹重新Sync三、顺带app 模块内部关键文件日常写代码最常用进入app/文件夹app/build.gradle.kts单个模块构建配置applicationId、minSdk、签名、依赖、buildTypes、混淆开启等每天都要改。app/src/main/AndroidManifest.xmlApp清单文件包名、权限、Activity注册、启动页、应用图标、组件声明安卓系统识别App的入口。app/src/main/javaJava/Kotlin 业务代码目录app/src/main/res资源目录布局layout、图片drawable、字符串strings、样式styleapp/proguard-rules.pro代码混淆规则文件四、极简记忆口诀settings.gradle.kts登记有几个模块根build.gradle.kts统一锁定AGP、Kotlin版本gradle.properties全局开关和版本常量local.properties本机SDK路径不上传gitgradle-wrapper.properties锁定项目Gradle版本gradlew执行构建命令app/build.gradle.kts单个App打包、依赖、编译配置五、新手避坑小规则不要删除gradle文件夹、gradlew脚本否则项目无法构建local.properties永远不要提交Git构建报错先删所有build和.gradle文件夹重新同步多版本Gradle只改本项目gradle-wrapper.properties不动全局环境。
打开 Android Studio 项目第一层就是项目根目录很多人只会点开 app 模块写代码完全不知道外层文件作用下面按「必懂核心」「构建配置」「Git忽略」「缓存日志」分类讲清楚同时附上 app 模块内部关键文件。一、根目录第一层整体结构预览项目名/ ├── .gradle/ Gradle 构建缓存目录不用管 ├── .idea/ Android Studio 配置文件IDE专属 ├── app/ 主应用模块99%业务代码在这里 ├── build/ 整个项目构建输出产物可删除 ├── gradle/ Gradle Wrapper 包装脚本控制Gradle版本 ├── .gitignore Git忽略文件配置 ├── build.gradle.kts 【全局项目构建配置根级】 ├── gradle.properties 全局Gradle属性、开关、AndroidX配置 ├── gradlew / gradlew.bat 跨平台Gradle执行脚本Mac/Windows ├── local.properties 本地SDK路径、NDK路径每个人电脑不一样 ├── settings.gradle.kts 项目模块注册入口告诉Gradle有哪些子模块二、逐个文件详细解释1. settings.gradle.kts 【超级重要】作用告诉 Gradle 当前项目包含哪些子模块是项目入口清单默认内容pluginManagement{repositories{google()mavenCentral()}}dependencyResolutionManagement{repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)repositories{google()mavenCentral()}}// 注册app模块include(:app)新增 library 组件化模块必须在这里include(:xxx)否则AS识别不到里面同时配置了依赖仓库地址google、mavenCentral。2. 根目录 build.gradle.kts项目全局构建只做一件事全局声明 AGP、Kotlin 插件版本所有子模块共用典型内容plugins{id(com.android.application)version9.3.0applyfalseid(com.android.library)version9.3.0applyfalseid(org.jetbrains.kotlin.android)version2.0.0applyfalse}apply false只定义版本不在根目录直接运行插件app 模块只需要直接引用插件不用重复写版本统一版本避免冲突。3. gradle.properties 全局配置文件高频修改整个项目全局开关、常量、编译参数都写这里常用配置# 开启AndroidX、Jetifier兼容新项目必开 android.useAndroidXtrue android.enableJetifiertrue # JVM内存、并行构建 org.gradle.jvmargs-Xmx4g org.gradle.paralleltrue # 全局版本常量子模块直接引用 minSdkVersion24 targetSdkVersion36 compileSdkVersion36用途统一 minSdk、compileSdk改一处全部模块生效开启构建加速、AndroidX、R类优化等开关。4. local.properties 【本地环境配置禁止提交Git】记录当前电脑本地环境路径每台电脑自动生成内容不一样示例sdk.dirC\:\\Users\\xxx\\AppData\\Local\\Android\\Sdk ndk.dirxxx作用告诉项目本机 Android SDK 安装在哪换电脑、换SDK路径会自动重新生成不要手动修改不要上传代码仓库。5. gradle 文件夹控制Gradle版本核心gradle/wrapper/ └── gradle-wrapper.properties唯一核心文件gradle-wrapper.propertiesdistributionUrlhttps\://services.gradle.org/distributions/gradle-8.10-all.zip决定当前项目用哪个 Gradle 版本也就是你上一问关心的多版本管理的源头。6. gradlew / gradlew.bat 脚本文件gradlewMac / Linux 终端执行构建脚本gradlew.batWindows CMD/PowerShell 执行脚本使用示例# Mac打包正式包./gradlew assembleRelease# Windowsgradlew.bat assembleRelease强制建议永远用这两个脚本构建不要用系统全局gradle避免版本错乱7. .gitignore Git忽略文件配置哪些文件不需要提交到代码仓库模板内容# 构建产物 /build/ /.gradle/ # 本地环境文件 local.properties # IDE配置 .idea/caches # 日志、APK、签名文件 *.apk *.log作用防止每个人IDE缓存、编译产物、本地路径冲突提交上去。8. .idea 文件夹Android Studio IDE配置存放代码格式化规则、运行配置、索引、模块配置、版本控制记录只给AS用Gradle构建不依赖可以加入git提交团队统一代码风格也可以忽略不影响项目运行。9. .gradle 文件夹Gradle 构建过程缓存、依赖缓存、任务缓存可以随时删除下次构建自动重新生成体积很大定期删除可清理C盘空间。10. 根目录 build 文件夹整个项目编译中间产物、依赖解压包完全可删清理构建异常第一操作删除所有build文件夹重新Sync三、顺带app 模块内部关键文件日常写代码最常用进入app/文件夹app/build.gradle.kts单个模块构建配置applicationId、minSdk、签名、依赖、buildTypes、混淆开启等每天都要改。app/src/main/AndroidManifest.xmlApp清单文件包名、权限、Activity注册、启动页、应用图标、组件声明安卓系统识别App的入口。app/src/main/javaJava/Kotlin 业务代码目录app/src/main/res资源目录布局layout、图片drawable、字符串strings、样式styleapp/proguard-rules.pro代码混淆规则文件四、极简记忆口诀settings.gradle.kts登记有几个模块根build.gradle.kts统一锁定AGP、Kotlin版本gradle.properties全局开关和版本常量local.properties本机SDK路径不上传gitgradle-wrapper.properties锁定项目Gradle版本gradlew执行构建命令app/build.gradle.kts单个App打包、依赖、编译配置五、新手避坑小规则不要删除gradle文件夹、gradlew脚本否则项目无法构建local.properties永远不要提交Git构建报错先删所有build和.gradle文件夹重新同步多版本Gradle只改本项目gradle-wrapper.properties不动全局环境。
