Android 的 .gitignore

适用于 Android 的 20 条忽略规则,可直接复制到您的仓库。

移动操作系统

Android 的完整 .gitignore

# 由 LFGitignore - https://lfgitignore.com 生成
# 创建:2026-10-31 22:50:16 UTC
# 技术:Android

### Android ###
# Gradle 缓存
.gradle/
# 构建输出目录
build/
.kotlin/
# Android 本地配置
local.properties
# 日志档案
*.log
# Android 捕获
captures/
.externalNativeBuild/
.cxx/
# Android 应用程序包
*.aab
# Android 封装
*.apk
output-metadata.json
# IntelliJ 模块文件
*.iml
# IntelliJ IDEA 项目文件
.idea/
misc.xml
deploymentTargetDropDown.xml
render.experimental.xml
# Java 密钥库
*.jks
# Android 密钥库
*.keystore
# 谷歌服务配置
google-services.json
*.hprof

这些 Android 规则实际上忽略了什么

以下列出了每个忽略模式及其加入 .gitignore 的原因。

Gradle 文件

模式 忽略的内容
.gradle/ Gradle 缓存
build/ 构建输出目录
.kotlin/ Gradle 文件

本地配置文件(sdk路径等)

模式 忽略的内容
local.properties Android 本地配置

日志/操作系统文件

模式 忽略的内容
*.log 日志档案

Android Studio 生成的文件和文件夹

模式 忽略的内容
captures/ Android 捕获
.externalNativeBuild/ Android Studio 生成的文件和文件夹
.cxx/ Android Studio 生成的文件和文件夹
*.aab Android 应用程序包
*.apk Android 封装
output-metadata.json Android Studio 生成的文件和文件夹

IntelliJ

模式 忽略的内容
*.iml IntelliJ 模块文件
.idea/ IntelliJ IDEA 项目文件
misc.xml IntelliJ
deploymentTargetDropDown.xml IntelliJ
render.experimental.xml IntelliJ

密钥库文件

模式 忽略的内容
*.jks Java 密钥库
*.keystore Android 密钥库

Google 服务(例如 API 或 Firebase)

模式 忽略的内容
google-services.json 谷歌服务配置

Android 分析

模式 忽略的内容
*.hprof Android 分析

如何将此 .gitignore 用于 Android

  1. 复制上面的Android规则,或者直接下载文件。
  2. 在 Git 仓库根目录创建名为 .gitignore 的文件,并将规则粘贴进去。
  3. 如果其中一些文件已被跟踪,请运行 git rm -r --cached . 然后再次提交 - Git 仅将忽略规则应用于未跟踪的文件。
  4. 提交 .gitignore 以便团队中的每个人都共享相同的规则。

其他 操作系统 .gitignore 模板

查看每个 操作系统 模板