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

如何在Android Studio中禁止Git提交特定包与文件?

问题描述

构建项目后Android Studio会自动生成大量构建缓存、临时产物文件,执行commit操作时,提交面板会充斥大量不需要commit或push到代码仓库的文件。
提交面板冗余文件示意图
如何配置Git忽略这类自动生成的文件,避免其被误提交、推送?

已尝试的操作

曾尝试将对应包目录添加到.gitignor文件中,但配置没有产生任何效果。
.gitignore配置无效示意图

解决方案

你配置不生效的第一个核心问题是文件名拼写错误: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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.28 13:15:25