VSCode全局搜索排除node_modules需配置search.exclude而非files.exclude，正确写法为{"**/node_modules": true}，并确保未填写“files to include”框。

如何在 VSCode 搜索中真正排除 node_modules

VSCode 默认不会自动跳过 node_modules，哪怕你看到设置里写了 "files.exclude"，那也只影响资源管理器显示，对全局搜索（Ctrl+Shift+F）完全无效。真正起作用的是 search.exclude。

• search.exclude 是独立配置项，必须显式设置，和 files.exclude 互不影响
• 推荐在工作区 .vscode/settings.json 中配置，避免污染全局设置
• 路径模式支持 glob，但注意：开头不加 **/ 时，只匹配项目根目录下的同名文件夹；加了才递归匹配所有层级的 node_modules
• Windows 用户要注意反斜杠转义问题，统一用正斜杠或双反斜杠

search.exclude 的正确写法与常见错误

错误示例："node_modules": true —— 这是旧版写法，VSCode 1.80+ 已弃用，会静默失效。

正确写法（推荐）：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

"search.exclude": {
  "**/node_modules": true,
  "**/bower_components": true,
  "**/*.log": true
}

• "**/node_modules" 覆盖所有嵌套层级，包括 lerna/yarn workspaces 中的子包内 node_modules
• 如果只想排除根目录的 node_modules，写 "node_modules": true 即可，但多数项目需要前者
• 值设为 false 可临时启用某类路径的搜索，适合调试时按需打开
• 不要写成 "**/node_modules/**" —— 多余的 /** 不影响功能，但易引发误解，官方文档也没这么写

为什么改了 search.exclude 还搜出 node_modules？

最常见原因是搜索时勾选了右上角的 files to include 输入框（图标是 ?），它会覆盖 search.exclude 设置。

• 只要该输入框非空（比如填了 *.ts 或 src），VSCode 就忽略 search.exclude，只按你写的 include 规则扫描
• 解决方法：清空 files to include 输入框，或明确加上 !**/node_modules（但不如直接清空来得可靠）
• 另一个干扰源是插件，比如某些“增强搜索”类插件会绕过原生 search.exclude，可尝试禁用后验证
• 重启 VSCode 并不必要，配置保存后实时生效；但若刚从旧版本升级，检查是否残留 search.useRipgrep 设为 false（旧版行为不同）

大型 monorepo 下的额外考虑

Yarn / pnpm workspace 或 Nx 项目里，node_modules 可能分散在多个位置（根目录 + 各 package 子目录），单靠 "**/node_modules" 通常够用，但仍有边界情况。

• pnpm 的硬链接结构有时会让 VSCode 搜索误判路径，可追加排除 "**/.pnpm/**"
• 如果用了 nohoist，某些子包的 node_modules 会被保留，"**/node_modules" 依然能覆盖
• 不想手动维护 exclude 列表？可以结合 search.followSymlinks 设为 false，减少因符号链接导致的重复扫描（但会影响其他正常链接）
• 极少数情况下，VSCode 搜索缓存异常，可尝试删除 $HOME/.vscode/<code> 目录下对应工作区的 <code>searchHistory 缓存（不常需）

真正麻烦的不是怎么写排除规则，而是忘记检查 files to include 是否被意外填写——这个输入框太小，又总在搜索框右侧边缘，一不留神就把它当装饰了。