编辑 .gitignore 文件的目的是告诉 Git 哪些文件或目录不需要被版本控制(即不提交到仓库中)。以下是如何创建和编辑 .gitignore 文件的详细步骤:
🔹 一、.gitignore 文件的位置
- 通常放在 项目根目录下 ,这样它会影响整个项目。
- 也可以在子目录中添加
.gitignore 文件,仅影响该子目录的内容。
🔹 二、创建 .gitignore 文件
方法一:手动创建
touch .gitignore
然后使用你喜欢的编辑器打开它,例如:
nano .gitignore
# 或
vim .gitignore
# 或
code .gitignore # 如果你用 VS Code
🔹 三、.gitignore 文件语法
| 规则 | 示例 | 含义 |
| 空行 | | 被忽略 |
| 注释 | # This is a comment | 以#开头的是注释 |
| 单个文件 | filename.log | 忽略名为filename.log的文件 |
| 通配符 | *.log | 忽略所有.log文件 |
| 目录 | /logs/ | 忽略根目录下的logs文件夹及其内容 |
| 反向匹配 | !important.log | 不忽略important.log(即使前面有规则忽略.log) |
示例 .gitignore 内容:
# 忽略日志文件
*.log
*.tmp
# 忽略系统文件
.DS_Store
Thumbs.db
# 忽略 node_modules(Node.js 项目)
/node_modules/
/dist/
# 忽略 IDE 配置文件
.idea/
.vscode/
*.swp
# 忽略环境变量配置
.env
.env.local
# 但保留某个特定文件
!.env.example
🔹 四、注意事项
- 已经提交过的文件不会被
.gitignore 忽略
你需要先从 Git 中删除它:
git rm --cached <file>
- 全局
.gitignore
如果你想设置适用于所有项目的忽略规则(如编辑器临时文件),可以设置全局 .gitignore:
git config --global core.excludesfile '~/.gitignore\_global'
然后你可以编辑这个文件:
nano ~/.gitignore_global
🔹 五、推荐资源