如何忽略特定文件或文件夹（使用 .gitignore）？

一、什么是.gitignore文件

.gitignore是一个纯文本文件，用于告诉Git哪些文件或文件夹应该被忽略，不纳入版本控制。这个文件通常位于项目的根目录下，但也可以出现在子目录中，甚至可以有多个.gitignore文件。

当你在项目中创建.gitignore文件后，Git会自动忽略其中列出的文件和目录。这意味着这些文件不会出现在git status的输出中，也不会被git add命令包含，更不会被提交到仓库。

.gitignore特别适用于以下几种情况：

• 忽略操作系统自动生成的文件（如Thumbs.db、.DS_Store）
• 排除IDE或编辑器生成的临时文件（如.idea/、*.swp）
• 过滤掉编译生成的中间文件（如*.o、*.class）
• 避免上传包含敏感信息的配置文件

二、如何创建.gitignore文件

创建.gitignore文件非常简单，你可以使用任何文本编辑器来完成这个操作。以下是具体步骤：

1. 打开终端或命令行工具，导航到你的项目根目录
2. 使用命令touch .gitignore创建一个空文件
3. 用你喜欢的文本编辑器打开这个文件
4. 添加需要忽略的文件和目录模式
5. 保存文件

在Windows系统中，你可能需要通过资源管理器来创建这个文件。右键点击项目文件夹，选择"新建"→"文本文档"，然后将文件名改为.gitignore（注意前面的点）。如果系统提示"必须输入文件名"，你可以先命名为gitignore.txt，然后在命令行中使用ren gitignore.txt .gitignore来重命名。

创建完成后，记得将.gitignore文件本身添加到Git仓库中：

git add .gitignore
git commit -m "Add .gitignore file"

三、.gitignore的基本语法规则

.gitignore文件遵循特定的语法规则，理解这些规则对于正确使用它至关重要。

1、忽略特定文件

要忽略单个文件，只需在.gitignore中写入文件名即可。例如：

config.ini
error.log

这将忽略项目根目录下的config.ini和error.log文件。

2、忽略特定文件夹

要忽略整个目录，在目录名后加上斜杠/：

tmp/
logs/

这会忽略项目中的tmp和logs目录及其所有内容。

3、使用通配符

.gitignore支持通配符模式匹配：

• *匹配任意数量的字符
• ?匹配单个字符
• []匹配括号内的任一字符

例如：

*.log       # 忽略所有.log文件
?.tmp       # 忽略所有单字符名称的.tmp文件
test[0-9]   # 忽略test0到test9

四、常见.gitignore模式示例

1、忽略操作系统生成的文件

不同操作系统会生成特定的隐藏文件，这些通常应该被忽略：

# macOS
.DS_Store
._*
# Windows
Thumbs.db
ehthumbs.db
Desktop.ini
# Linux
*~

2、忽略IDE或编辑器生成的文件

开发工具会生成各种临时文件和项目配置：

# IntelliJ IDEA
.idea/
*.iml
# VS Code
.vscode/
*.code-workspace
# Vim
*.swp
*.swo

3、忽略依赖文件夹

项目依赖通常不需要纳入版本控制：

# Node.js
node_modules/
# Python
__pycache__/
*.pyc
# Java
target/

五、高级.gitignore技巧

1、全局.gitignore配置

你可以创建一个全局.gitignore文件，应用于所有Git项目：

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

然后编辑~/.gitignore_global文件添加通用忽略规则。

2、强制添加被忽略的文件

有时你可能需要添加一个被忽略的文件，可以使用-f选项：

git add -f ignored_file.txt

3、检查哪些文件将被忽略

使用以下命令检查特定文件是否会被忽略：

git check-ignore -v path/to/file

结语

.gitignore是Git工作流中不可或缺的一部分，它能帮助你维护干净、高效的代码仓库。通过合理配置忽略规则，你可以避免不必要的文件污染仓库历史，提高团队协作效率，同时保护敏感信息不被意外提交。现在就去检查你的项目，确保.gitignore配置得当吧！

常见问题

1、.gitignore文件应该放在哪里？

通常放在项目根目录，但也可以在子目录中添加额外的.gitignore文件。

2、为什么我的.gitignore规则不起作用？

可能是因为文件已经被Git跟踪。使用git rm --cached <file>停止跟踪，然后重新提交。

3、如何忽略除特定文件外的所有文件？

使用!前缀来排除：

*
!README.md