1 作用

.gitignore 用于声明哪些文件/目录不需要纳入 Git 版本管理。被忽略的文件既不会出现在 git status 中，也不能被 git add 添加（除非用 -f 强制）。

2 常用规则示例

# 日志
*.log
*.out

# 编译产物
*.o
*.class
*.so

# 临时/备份文件
*.swp
*.swo
*.lock
*.pid
*.sock
*~

# 编辑器与个人配置
.viminfo
.bashrc
.DS_Store
.idea/
.vscode/

# 目录
node_modules/
dist/
build/

3 语法要点

• * 匹配任意多个字符，? 匹配单个字符，** 匹配任意层级目录。
• 以 / 结尾表示目录。
• 以 # 开头表示注释。
• 以 \ 开头表示转义字面量。
• 以 . 开头的隐藏文件同样可以用通配符匹配，例如 .* 会忽略所有点文件；如果只想忽略仓库根目录下的隐藏文件，请写成 ./.*。

4 常用操作命令

# 查看某个文件/目录是否被忽略（--show 或 -v 显示具体命中哪条规则） git check-ignore -v <file> # 已被跟踪的文件，加入 .gitignore 不会再生效，需要先从索引中移除 git rm --cached <file> # 强制添加一个被忽略的文件 git add -f <file>

5 全局忽略文件

适合放编辑器临时文件等与具体仓库无关的规则：

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