忽略文件模式

什么是忽略文件模式

忽略文件模式是Git中一种用于指定哪些文件或目录不应被版本控制的机制。通过创建名为.gitignore的特殊文件，开发者可以明确告诉Git哪些内容应该被忽略。这个功能对于管理项目中的临时文件、编译产物、本地配置文件等非常有用。

.gitignore文件通常放在仓库的根目录下，但也可以出现在子目录中。Git会从当前目录开始向上查找.gitignore文件，直到仓库的根目录，然后将所有找到的规则合并应用。

忽略文件的基本语法

.gitignore文件使用简单的模式匹配语法：

1. 空行或以#开头的行会被忽略（作为注释）
2. 标准的glob模式匹配
3. 以斜杠/开头防止递归
4. 以斜杠/结尾指定目录
5. 以感叹号!开头表示否定模式

# 忽略所有.log文件
*.log

# 但不要忽略important.log
!important.log

# 忽略根目录下的build文件夹
/build/

# 忽略所有目录下的temp文件夹
temp/

常见忽略模式示例

忽略特定文件扩展名

# 忽略日志文件
*.log

# 忽略编译产物
*.o
*.a
*.so

忽略特定目录

# 忽略node_modules目录
node_modules/

# 忽略所有build目录
build/

# 忽略.idea目录（JetBrains IDE配置）
.idea/

忽略特定路径的文件

# 忽略特定路径下的文件
doc/*.txt

# 但不忽略doc子目录下的txt文件
!doc/**/*.txt

高级忽略模式

使用双星号匹配多级目录

# 匹配任意层级的logs目录
**/logs/

# 匹配任意层级的debug.log文件
**/debug.log

排除特定情况

# 忽略所有.txt文件
*.txt

# 但不忽略important.txt
!important.txt

# 忽略build目录下的所有文件
build/*

# 但不忽略build目录下的config文件
!build/config

特定语言的忽略模式示例

JavaScript项目

# 依赖目录
node_modules/

# 构建产物
dist/
build/
*.min.js

# 日志文件
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# 环境变量文件
.env
.env.local

Python项目

# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# C extensions
*.so

# Distribution / packaging
.Python
build/
develop-eggs/
dist/

全局忽略文件

除了项目特定的.gitignore外，Git还支持配置全局忽略文件：

git config --global core.excludesfile ~/.gitignore_global

全局忽略文件适用于所有本地仓库，通常用于忽略编辑器临时文件、操作系统生成文件等：

# macOS
.DS_Store

# Windows
Thumbs.db

# Vim
*.swp
*.swo

忽略已跟踪的文件

有时需要忽略已经被Git跟踪的文件，这时需要先取消跟踪：

git rm --cached <file>

然后将其添加到.gitignore中。例如，要忽略已经被跟踪的config.ini：

git rm --cached config.ini
echo "config.ini" >> .gitignore
git add .gitignore
git commit -m "Stop tracking config.ini"

调试忽略规则

如果忽略规则没有按预期工作，可以使用git check-ignore命令调试：

git check-ignore -v <file>

这会显示哪个忽略规则匹配了指定文件。例如：

git check-ignore -v node_modules/package.json

忽略文件的优先级

Git应用忽略规则的顺序如下：

1. 命令行指定的忽略规则
2. 当前目录的.gitignore
3. 父目录的.gitignore（递归向上直到仓库根目录）
4. $GIT_DIR/info/exclude
5. 全局core.excludesFile指定的文件

后定义的规则会覆盖先定义的规则，否定模式（!）可以覆盖前面的忽略规则。

实际项目中的最佳实践

1. 保持.gitignore文件整洁：按类别分组规则，添加注释说明
2. 考虑提交模板文件：如config.sample.ini，让用户复制后自行配置
3. 不要忽略必要的构建工具：如Makefile或package.json
4. 定期检查忽略规则：随着项目发展，可能需要更新忽略规则

# ================
# 项目构建产物
# ================
/dist/
/build/
/out/

# ================
# 依赖目录
# ================
/node_modules/
/bower_components/

# ================
# 开发环境文件
# ================
.env
.env.local

特殊情况的处理

忽略空目录

Git本身不会跟踪空目录，但有时需要保留目录结构。常见的解决方案是添加.gitkeep文件：

mkdir -p logs
touch logs/.gitkeep

然后在.gitignore中：

logs/*
!logs/.gitkeep

忽略权限变更

在跨平台开发时，文件权限变化可能导致不必要的变更。可以配置Git忽略文件模式变更：

git config core.fileMode false

跨平台注意事项

不同操作系统对文件名大小写和路径分隔符的处理不同：

# Windows/Mac不区分大小写，Linux区分
# 明确指定大小写可以避免问题
/Temp/
/temp/

路径分隔符最好使用正斜杠/，Git会自动转换为当前系统的格式。

自动化生成忽略文件

许多工具可以自动生成适合特定项目类型的.gitignore：

• gitignore.io
• IDE和框架通常提供默认的忽略文件模板

例如，使用gitignore.io为React项目生成：

curl https://www.toptal.com/developers/gitignore/api/node,react > .gitignore

忽略文件与Git属性

.gitignore可以与.gitattributes文件配合使用，实现更精细的控制：

# .gitattributes
*.min.js -diff -merge

这告诉Git不要比较或合并压缩后的JS文件，即使它们被跟踪。