node_modules不该被Git提交，需同步配置Git跟踪、VSCode文件监视器、搜索排除及AI插件忽略规则：先用git rm -r --cached移除已跟踪项，再在.gitignore中写node_modules/；VSCode中设files.watcherExclude和search.exclude为/node_modules/；AI插件如CodeGeeX需单独配codegeex.ignorePatterns。
node_modules 不该被 Git 提交，但 VSCode 里还总提示它有变更？不是设置没生效，而是你可能漏掉了三个独立环节：Git 跟踪状态、VSCode 文件监视器、VSCode 搜索行为——每个都得单独关，缺一不可。
node_modules 已被 Git 跟踪，.gitignore 无效
这是最常被跳过的前提：如果 node_modules 曾经被 git add 过，哪怕现在 .gitignore 里写了 node_modules/，Git 仍会继续追踪它。
- 先运行
git ls-files | grep node_modules，如果有输出，说明它已被 Git 记录 - 执行
git rm -r --cached node_modules，再git commit -m "remove node_modules from tracking" -
.gitignore中必须写成node_modules/（末尾斜杠表示目录），不能只写node_modules或**/node_modules - 别用全局
.gitignore或core.excludesFile替代项目级配置，团队协作时容易不一致
VSCode 文件监视器还在扫 node_modules
即使 Git 不管了，VSCode 自己的文件监听器（用于自动刷新、搜索索引、智能提示）默认仍会扫描 node_modules，导致 CPU 占用高、源代码管理视图里反复出现“未暂存更改”。
- 打开设置（
Ctrl+,），搜files.watcherExclude - 添加规则：
"**/node_modules/**": true（注意双星号开头 + 双斜杠结尾） - 改完必须重启 VSCode 窗口，重载窗口（
Ctrl+Shift+P → Developer: Reload Window）不生效 - 不要写成
/node_modules/或node_modules/，前者匹配失败，后者只作用于根目录
VSCode 搜索（Ctrl+Shift+F）仍搜出 node_modules
files.exclude 对搜索完全没影响。真正控制全局搜索的是 search.exclude，而且它的规则优先级会被搜索面板右下角的 “Files to include” 输入框覆盖。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 在
.vscode/settings.json中添加："search.exclude": {"**/node_modules": true} - 别写
"node_modules": true—— VSCode 1.80+ 已弃用该写法，静默失效 - 检查搜索面板右下角是否点了
⋯ → Files to exclude或填了Files to include；只要这个输入框非空，search.exclude就被无视 - 临时验证：清空 “Files to include”，再搜关键词，看结果是否干净
CodeGeeX 或其他 AI 插件还在分析 node_modules
像 CodeGeeX 这类插件不读 .gitignore 或 VSCode 的通用排除设置，必须单独配 codegeex.ignorePatterns。
- 确认插件版本 ≥ 2.4.0（旧版不支持 ignore）
- 在
.vscode/settings.json中加："codegeex.ignorePatterns": ["**/node_modules/**"] - 必须重启 VSCode 窗口，否则规则不加载
- 别漏掉数组语法——写成字符串或对象都会让插件禁用补全功能
真正麻烦的不是某一条规则写错，而是四个地方（Git、watcher、search、AI 插件）各自维护一套排除逻辑，且互不继承。改完一个，还得挨个验证是否真“看不见”了。
