You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Android Studio项目中Git需忽略哪些文件夹?.idea是否需忽略?

Android Studio项目中Git忽略规则指南

Great question! When working on Android Studio projects, knowing exactly what to exclude from Git saves you from cluttering your repo with unnecessary, environment-specific files. Let's break this down clearly:

必须忽略的核心文件夹与文件

These are non-negotiable—they're auto-generated, tied to your local environment, or contain build artifacts that don't belong in shared version control:

  • build/: 存放所有编译生成的产物(APK、中间编译文件、调试符号等),每个人的本地编译结果可能有差异,完全没必要提交。
  • .gradle/: Gradle的本地缓存和配置文件,和你的本地Gradle版本、环境绑定,不需要同步给团队。
  • local.properties: 这个文件里存储了你的Android SDK本地路径,每个人的SDK安装位置大概率不一样,绝对不能提交到公共仓库。
  • *.iml: Android Studio为每个模块生成的配置文件,属于IDE特定文件,不需要共享。

关于.idea/文件夹的明确建议

This is the most common point of confusion, so let's settle it:

绝大多数情况下,直接忽略整个.idea/文件夹。这个目录里的内容几乎都是Android Studio的本地个性化配置——比如窗口布局、插件启用状态、本地运行调试配置、代码折叠偏好等等,这些都是个人开发环境的设置,对团队其他成员毫无意义。

唯一的例外:如果你的团队有统一的代码风格配置(存储在.idea/codeStyles/子目录下),可以单独把这个目录从忽略规则中排除,让团队共享一致的代码风格。但这种情况不多见,大部分项目直接忽略整个.idea/更省心。

其他需要补充忽略的内容

Don't forget these easy-to-miss files/folders:

  • *.apk、*.aab: 打包完成的安装包,不需要提交到Git(如果需要分发安装包,建议用专门的文件存储或发布平台)。
  • *.log: 本地调试过程中生成的日志文件,没有长期保留或共享的价值。
  • captures/: Android Studio生成的性能分析截图、视频捕获文件。
  • outputs/: 和build/类似,存放构建输出的各类产物。
  • .cxx/: 使用NDK开发时生成的编译文件,和本地环境强相关。

快速配置.gitignore

Create a .gitignore file at your project root and paste these rules to cover all the above cases:

# Android Studio IDE files
.idea/
*.iml

# Gradle related
.gradle/
build/
outputs/

# Local environment config
local.properties

# Build artifacts
*.apk
*.aab

# Debug & capture files
*.log
captures/

# NDK related
.cxx/

内容的提问来源于stack exchange,提问作者mcfly soft

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.25 07:22:42