如何在Android Studio中禁止Git提交特定包与文件?
问题描述
构建项目后Android Studio会自动生成大量构建缓存、临时产物文件,执行commit操作时,提交面板会充斥大量不需要commit或push到代码仓库的文件。
如何配置Git忽略这类自动生成的文件,避免其被误提交、推送?
已尝试的操作
曾尝试将对应包目录添加到.gitignor文件中,但配置没有产生任何效果。
解决方案
你配置不生效的第一个核心问题是文件名拼写错误:Git识别的忽略规则文件固定名为.gitignore,你少写了末尾的字母e,Git不会读取命名错误的.gitignor文件中的规则,先把文件名修正。
修正文件名后,按以下步骤配置即可彻底解决问题:
1. 写入标准Android项目忽略规则
在项目根目录的.gitignore文件中,添加Android官方推荐的忽略规则,覆盖所有IDE生成文件、构建产物、本地配置类文件:
# Gradle构建相关 .gradle/ /build/ /app/build/ *.apk *.aab *.ap_ *.dex # Android Studio本地配置 .idea/ *.iml .DS_Store captures/ .externalNativeBuild/ .cxx/ local.properties
2. 清除已被跟踪的冗余文件缓存
如果之前已经把这类自动生成的文件提交到过Git仓库,仅添加.gitignore规则不会生效——Git会持续跟踪已经纳入版本管理的文件,需要在项目根目录执行以下命令清除缓存,让忽略规则生效:
# 清除所有文件的Git本地缓存 git rm -r --cached . # 重新按照.gitignore规则添加文件 git add . # 提交规则变更 git commit -m "chore: 更新gitignore规则,忽略构建产物与IDE本地文件"
执行完之后,后续提交时这些自动生成的文件就不会再出现在提交面板里了。
3. 本地临时忽略可选方案
如果只是自己本地不想看到这类文件,不需要同步规则给团队其他成员,也可以直接在Android Studio里配置:
- 打开设置 → Version Control → Ignored Files
- 点击加号添加要忽略的文件/目录,选择对应匹配规则即可
- 注意:该配置仅存在于你本地的Android Studio设置中,不会随仓库同步给其他协作者,团队协作场景优先使用项目根目录下的
.gitignore配置。
内容的提问来源于stack exchange,提问作者Aiman Alyosofi
相关产品推荐
相关产品推荐

