.gitignore只对未跟踪文件生效，已提交文件需用git rm -r --cached清理缓存；团队应采用github官方模板库+项目/全局/个人三级分层配置，并将缓存清理命令写入contributing.md强制执行。
直接用 GitHub 官方 .gitignore 模板库 + 团队级分层配置，就能解决 90% 的协作污染问题。临时改、手写漏、IDE 文件乱提交——这些都不是技术问题，是规则没落地。
为什么 .gitignore 在团队里总不生效
常见现象：新成员 clone 项目后 git status 一堆 .idea/、node_modules/、__pycache__/；有人 commit 了 .env，CI 突然报密钥泄露；改完 .gitignore 发现文件还在暂存区——根本不是规则写错了，而是 Git 已经在跟踪它们了。
-
.gitignore只对「未跟踪文件」生效；已git add过的文件，加再多次忽略也无效 - 团队没统一模板时，每个人本地的
.gitignore差异会引发 merge conflict，尤其在git pull后 - IDE 自动生成的配置（如
.vscode/）常被忽略但没进模板，新人一开项目就自动 commit
用 gitignore 模板库快速生成标准规则
GitHub 官方维护的 gitignore 模板库 是最可靠起点，覆盖 Python、Java、Node、Vue、VSCode、IntelliJ 等全部主流场景。
- 直接下载对应模板：
curl -o .gitignore https://www.php.cn/link/b401bc1510073e67541966c560cf6307/raw/main/Python.gitignore - 混合项目用
cat合并：cat Python.gitignore Node.gitignore Global/VisualStudioCode.gitignore > .gitignore - 别只复制模板——必须手动检查三处：
node_modules/（前端）、venv/或.venv/（Python）、target/或build/（Java/Gradle）是否已包含
三层忽略机制：项目级 + 全局级 + 个人级
单靠一个 .gitignore 文件无法覆盖所有协作场景，必须分层管理：
-
项目级（
.gitignore，提交到仓库）：放语言/框架/构建产物等通用规则，所有成员强制遵守 -
全局级（
~/.gitignore_global）：运行git config --global core.excludesfile ~/.gitignore_global后，对本机所有仓库生效；适合放.DS_Store、Thumbs.db、*.swp等系统/编辑器文件 -
个人级（
.git/info/exclude）：仅当前仓库生效，不提交、不共享；适合临时调试生成的local-test-output/或私有密钥占位文件
注意：三者优先级是「个人级 > 项目级 > 全局级」，但 !xxx 否定规则不能跨层级穿透——比如全局忽略了 *.log，项目级 !.important.log 依然无效。
修复已跟踪但该忽略的文件
这是最常卡住团队的一步：规则写了，git status 还是显示那些文件。因为它们早已被 Git 跟踪。
- 先清空缓存（不删本地文件）：
git rm -r --cached .，再git add .，最后git commit -m "chore: apply .gitignore" - 只想清理特定目录？用
git rm -r --cached node_modules/，比全量重置更安全 - 如果
git rm -r --cached .报错「pathspec did not match」，说明有未提交变更，先git stash再操作 - CI/CD 流水线里千万别加
--cached操作——它只应在开发者本地执行一次
真正难的不是写规则，而是让所有人同一时间、同一方式执行一次「缓存清理」。建议把这个命令写进项目 CONTRIBUTING.md 的第一行，新成员 setup 环境时必须运行。
