WebStorm Local Changes莫名显示未修改的node_modules文件变更

排查顺序按问题出现概率从高到低排列： #

• 优先校验.gitignore规则有效性
  首先打开项目根目录的.gitignore文件，确认存在一行node_modules/（末尾必须带斜杠，代表匹配整个目录）。如果规则已经存在还是出问题，在项目根目录终端执行：

  git check-ignore -v 【替换成变更列表里任意一个node_modules下的文件路径】
  

  执行后如果没有任何输出，说明node_modules根本没被git正确忽略，90%的情况是你之前曾经把node_modules提交到过git缓存，光加忽略规则没用，需要执行以下命令清除git索引里的跟踪记录：

  git rm -r --cached node_modules
  git commit -m "chore: remove tracked node_modules from git index"
  

  提交完成后git就不会再跟踪该目录下的任何文件改动。
• 确认是否是依赖安装操作触发的真实文件改动
  如果你修改业务代码期间执行过npm install/yarn/pnpm install类命令，哪怕没有手动改依赖配置，很多依赖包的postinstall脚本会自动生成适配当前系统、node版本的二进制文件或缓存文件，这些文件改动不是你手动编辑的，但属于文件系统层面的真实变更，自然会被版本控制检测到。这种情况不需要额外处理，只要确保node_modules被正确忽略即可，建议团队统一锁依赖版本，不要随意跨分支执行无参数的依赖安装命令。
• 修复WebStorm自身索引误报问题
  如果在终端执行git status看不到任何node_modules下的变更，只有WebStorm的Local Changes面板提示改动，就是IDE缓存索引异常：
  1. 打开WebStorm设置，进入Version Control > Ignored Files，手动添加忽略规则，选中本地项目下的node_modules目录，强制IDE不扫描该目录的版本变更
  2. 点击顶部菜单File > Invalidate Caches...，勾选Clear file system cache and Local History选项，点击Invalidate and Restart，等IDE重启重建完索引后误报就会消失
  3. 额外检查自动保存、ESLint自动修复、保存时自动格式化等功能的生效范围，把node_modules排除在自动处理目录之外，避免IDE后台自动修改该目录下的文件。
• 排查文件系统兼容问题
  如果是Windows/macOS系统开发，默认文件系统大小写不敏感，若项目内存在指向node_modules的软链接、或者曾经出现过Node_Modules这类大小写混写的目录名，会导致git检测异常，执行git config core.ignorecase true，同时把相关软链接路径加入.gitignore即可解决。

注意：任何情况下都不建议把node_modules目录提交到git仓库，除了会引发无意义的变更冲突，还会导致仓库体积极速膨胀，协作时统一通过lock文件安装依赖即可。

内容的提问来源于stack exchange，提问作者Alexandra