先确认node_modules是否已被Git跟踪：运行git ls-files | grep node_modules，有输出则需执行git rm -r --cached node_modules并提交；.gitignore应写为node_modules/（末尾带斜杠）；VSCode需配置files.watcherExclude为"/node_modules/": true；团队应统一使用项目级.gitignore。
Git 状态栏总显示 node_modules 被修改？先确认是不是真被 Git 跟踪了
VSCode 右下角 Git 图标上出现小数字，点开发现全是 node_modules 里的文件，第一反应不是“怎么忽略”，而是查它**是否已经被 Git 记录过**。如果早先不小心执行过 git add node_modules 或没配 .gitignore 就提交过，那这些文件就已是 Git 的“正式成员”，光靠 VSCode 设置或 .gitignore 是无效的。
- 运行
git ls-files | grep node_modules，有输出就说明已被跟踪 - 运行
git check-ignore -v node_modules/react/index.js（选一个子路径）可验证忽略规则是否生效 - 如果已跟踪，必须先从 Git 中移除：执行
git rm -r --cached node_modules，再提交
.gitignore 里写了 node_modules/ 还是不生效？检查路径和斜杠写法
.gitignore 对 node_modules 的写法非常敏感，常见失效是因为路径匹配规则理解偏差。Git 的忽略逻辑依赖行首空格、末尾斜杠、前置通配符，错一个字符就白写。
- ✅ 正确写法：
node_modules/（末尾带斜杠，只忽略该目录及其子内容） - ❌ 错误写法：
node_modules（不带斜杠，会同时匹配同名文件和目录，但某些旧 Git 版本行为不稳定） - ❌ 错误写法：
**/node_modules/（过度通配，没必要，且可能干扰其他规则优先级） - 确保
.gitignore文件位于 Git 仓库根目录，不是项目根目录的子文件夹里
VSCode 自己的文件监视器还在报变更？关掉 files.watcherExclude
即使 Git 不再管 node_modules，VSCode 编辑器本身会用文件系统监听器扫描变化，用于自动刷新、搜索、智能提示等。这个过程会卡顿、吃 CPU，还会在源代码管理视图里“假报”未暂存更改——因为它根本不管 Git 规则，只认自己配置。
- 打开 VSCode 设置（Ctrl+,），搜
files.watcherExclude - 编辑该设置，加入：
"**/node_modules/**": true - 注意格式：必须是双星号开头 + 双斜杠结尾，且整个键值对要写在 JSON 对象里，别漏逗号
- 改完重启 VSCode 才完全生效；临时可用命令面板执行
Developer: Restart Extension Host
团队协作时，有人还是看到 node_modules 提交？检查全局忽略和 core.excludesFile
个人本地没问题，但队友仍提交了 node_modules，大概率是他们机器上 Git 配置了全局忽略文件，而里面没包含 node_modules，或者用了错误的路径模式。
- 查全局忽略位置：
git config --get core.excludesFile（常见为~/.gitignore_global） - 确认该文件里是否含
node_modules/；没有就加上，并执行git config --global core.excludesFile ~/.gitignore_global - 提醒团队统一使用项目级
.gitignore，不要依赖各自本地配置，否则 CI/CD 构建时可能出问题
node_modules/，而是它曾经被 git add 过、或是 VSCode 的 watcher 在后台偷偷扫着、又或者某台机器的 Git 全局配置把它放行了——这些状态不会报错，只会安静地让变更提示反复出现。
