掌握.gitignore，团队开发效率++！
在使用 Git 进行版本控制时，我们经常会遇到需要排除某些文件或目录的情况。.gitignore文件就是解决这个问题的银弹，本文将带你全面了解它的使用技巧。
1. 什么是.gitignore？
.gitignore是一个纯文本文件，用于指定 Git 版本控制系统应该忽略哪些文件或目录。这些被忽略的文件通常包括：
- 系统自动生成的临时文件
- 编译生成的二进制文件
- 包含敏感信息的配置文件
- 依赖目录（如 node_modules）
- 开发工具配置文件
2. 创建.gitignore 文件
在项目根目录创建文件：
推荐文件结构：
1
2
3
4
5
| project-root/
├── .git/
├── .gitignore # 必须位于根目录
├── src/
└── ...
|
3. 语法规则详解
3.1 基础模式
1
2
3
4
5
6
7
8
9
| # 忽略所有.class文件
*.class
# 忽略特定目录
/target/
# 忽略所有txt文件，但保留important.txt
*.txt
!important.txt
|
3.2 高级模式
1
2
3
4
5
6
7
8
9
| # 忽略目录下的指定文件类型
src/*.tmp
# 忽略嵌套目录
**/__pycache__
# 排除隐藏目录
.*/
!.gitignore # 例外规则
|
3.3 特殊符号说明
| 符号 |
作用 |
示例 |
# |
注释 |
# 开发环境配置 |
* |
通配多个字符 |
*.log |
? |
通配单个字符 |
??.tmp |
! |
取反规则 |
!main.c |
/ |
指定目录 |
/build/ |
** |
递归匹配任意目录 |
**/test |
4. 按开发环境配置
4.1 操作系统文件
1
2
3
4
5
6
7
8
| # macOS
.DS_Store
# Windows
Thumbs.db
# Linux
*.swp
|
4.2 开发语言配置
1
2
3
4
5
6
7
8
9
10
11
| # Python
venv/
*.py[cod]
# JavaScript
node_modules/
npm-debug.log
# Java
*.jar
*.war
|
5. 实战技巧
5.1 全局配置（适用于所有项目）
创建全局忽略文件：
1
| git config --global core.excludesfile ~/.gitignore_global
|
5.2 已提交文件的处理
1
2
3
4
5
6
7
|
git rm --cached filename
git rm -r --cached .
git add .
git commit -m "更新.gitignore"
|
6. 常见问题排查
❓ 为什么忽略规则不生效？
- 检查文件是否已经被 Git 追踪
- 确认文件路径是否正确
- 清除 Git 缓存
- 验证.gitignore 位置是否正确
❓ 如何测试忽略规则？
1
| git check-ignore -v testfile.txt
|
7. 推荐资源
最佳实践提示：建议将.gitignore 文件本身提交到版本库，这样所有协作者都能共享相同的忽略规则。
