诸神缄默不语-个人CSDN博文目录
在日常使用 Git 进行版本控制时，我们经常会遇到一些不需要被提交到远程仓库的文件（例如日志文件、临时配置文件、环境变量文件等）。为了忽略这些文件的提交，Git 提供了一个非常有用的功能：.gitignore 文件。
本文将详细介绍 .gitignore 的作用、用法，以及如何处理已经被跟踪的文件。
文章目录
- 一、什么是 `.gitignore`
- 常见场景
- 二、创建 `.gitignore` 文件
- 创建方法
- 三、`.gitignore` 的语法规则
- 1. 忽略文件
- 2. 忽略文件夹
- 3. 通配符使用
- 4. 忽略某路径下的文件
- 四、忽略已被跟踪的文件
- 问题描述
- 解决方案
- 五、`.gitignore` 模板
- 六、总结
一、什么是 .gitignore
.gitignore 是一个文本文件，用于告诉 Git 在版本控制中忽略指定的文件或文件夹。这些被忽略的文件不会被提交到远程仓库，也不会显示在 git status 的输出中。
常见场景
- 忽略操作系统生成的临时文件（如
.DS_Store、Thumbs.db）。 - 忽略 IDE 或编辑器生成的配置文件（如
.vscode、*.suo）。 - 忽略包含敏感信息的文件（如
.env、credentials.json）。 - 忽略自动生成的构建文件（如
node_modules、dist）。
二、创建 .gitignore 文件
创建方法
在项目根目录下创建 .gitignore 文件：
touch .gitignore
在文件中添加需要忽略的文件或文件夹。例如：
# 忽略操作系统文件
.DS_Store
Thumbs.db
# 忽略日志文件
*.log
# 忽略环境变量文件
.env
# 忽略依赖文件夹
node_modules/
dist/
三、.gitignore 的语法规则
1. 忽略文件
在 .gitignore 文件中，直接写上文件名即可忽略该文件：
.env
2. 忽略文件夹
在文件夹名称后加上 /：
node_modules/
dist/
3. 通配符使用
*：匹配任意字符。?：匹配单个字符。[abc]：匹配括号内的任意字符。
示例：
# 忽略所有 `.log` 文件
*.log
# 忽略以 `temp` 开头的文件
temp*
# 忽略 `.txt` 文件，但保留 `important.txt`
*.txt
!important.txt
4. 忽略某路径下的文件
指定路径下的文件：
# 忽略 src 目录下的所有 `.tmp` 文件
src/**/*.tmp
四、忽略已被跟踪的文件
问题描述
如果某个文件已经被 Git 跟踪（即已被提交到仓库），即使后来将其添加到 .gitignore 文件中，Git 仍会继续跟踪它。
解决方案
-
更新
.gitignore文件
将需要忽略的文件加入.gitignore：.env -
停止对文件的跟踪
使用git rm --cached命令停止对该文件的跟踪：git rm --cached .env--cached参数只从 Git 的索引中移除文件，不会删除本地文件。
-
提交更改
提交更新后的.gitignore和移除文件的操作：git commit -m "Remove .env from version control and update .gitignore" -
验证忽略效果
修改被忽略的文件（如.env），运行git status检查，应该不会显示文件的更改。
五、.gitignore 模板
不同的项目可能需要不同的 .gitignore 配置。可以参考 GitHub 官方的 .gitignore 模板库，选择适合你的项目的模板。
例如，Node.js 项目的 .gitignore：
node_modules/
npm-debug.log
.env
dist/
Python 项目的 .gitignore：
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
# Environment variables
.env
六、总结
.gitignore是管理 Git 项目时的重要工具，能帮助我们避免提交不必要的文件。- 对于已经跟踪的文件，需要使用
git rm --cached停止其跟踪，并配合.gitignore文件实现忽略。 - 养成在项目初期就配置
.gitignore的习惯，可以避免不必要的麻烦。
希望通过这篇文章，你能够更好地理解和使用 .gitignore 文件！
