在 VSCode 中配置 search.exclude 排除大型依赖目录（如 node_modules、dist）是解决文件搜索变慢最直接的方法。该配置适用于项目文件数量过多导致搜索索引耗时的场景，风险在于误排除源代码目录会导致无法检索到相关文件。
先说结论：通过 settings.json 手动添加 glob 模式到 search.exclude 列表，可显著减少 ripgrep 扫描范围。
- 先定位：确认搜索延迟是否由 node_modules 或构建产物目录引起。
- 先做：在用户或工作区设置中写入排除规则，避免影响全局其他项目。
- 再验证：执行全局搜索测试，确认目标文件仍可见且响应速度恢复。
快速处理思路
本方案不涉及命令行操作，主要通过修改 JSON 配置文件生效。
{
"search.exclude": {
"**/node_modules": true,
"**/dist": true,
"**/build": true,
"**/.git": true
}
}将上述代码片段合并到现有的 settings.json 文件中，保存后无需重启 VSCode 即可生效。
为什么会这样
搜索变慢通常是因为底层工具 ripgrep 扫描了过多无需索引的文件。VSCode 默认会扫描工作区内的所有文件，包含构建产物和依赖包，这会显著增加 IO 开销。公开资料中没有看到可靠的量化数据表明具体提升百分比，但减少扫描文件数量必然降低 CPU 和磁盘占用。
分步处理
按以下步骤修改配置，每步完成后检查配置文件语法。
步骤 1：打开配置文件
使用快捷键 Ctrl+Shift+P (Mac 为 Cmd+Shift+P)，输入 Preferences: Open Settings (JSON) 并回车。此操作直接打开 settings.json 文件，避免图形界面转换错误。
步骤 2：添加排除规则
在 JSON 根对象中找到或创建 search.exclude 字段。若已存在 files.exclude，可参考其结构，但需独立配置 search.exclude 以确保搜索逻辑独立。
步骤 3：保存并重载
保存文件 (Ctrl+S)。若搜索仍未恢复，使用 Command Palette 执行 Developer: Reload Window 确保配置完全加载。
怎么验证是否生效
验证核心是确认搜索范围缩小且响应时间缩短。
检查点 1：搜索结果数量
执行全局搜索 (Ctrl+Shift+F)，输入常见关键词。若之前结果数为数千条且包含依赖包代码，配置后结果数应显著减少且不再包含 node_modules 内容。
检查点 2：响应速度
观察搜索框下方的状态提示。若之前显示 scanning... 持续时间过长，配置后应快速完成扫描。公开资料中没有看到可靠的量化数据支持具体毫秒数，以主观感知无明显卡顿为准。
常见坑
配置 search.exclude 时容易混淆 files.exclude 的作用域。
混淆 files.exclude 与 search.exclude
files.exclude 仅控制资源管理器可见性，默认不直接影响搜索，除非开启了 search.useIgnoreFiles。若只配置了 files.exclude 而搜索依然慢，需显式配置 search.exclude。
Glob 模式写法错误
路径模式需符合 glob 语法，例如 **/tmp 表示所有层级的 tmp 文件夹。若写成 /tmp 可能仅匹配根目录。错误写法会导致规则不生效，建议复制官方推荐模式。
常见问题
search.exclude 和 files.exclude 有什么区别？
search.exclude 仅影响搜索功能，files.exclude 仅影响文件列表显示。两者独立配置，但 search.exclude 默认会继承 files.exclude 中设为 true 的项。
配置后找不到某些文件怎么办？
检查是否误将源代码目录加入排除列表。临时在搜索框点击排除规则旁边的圆圈图标可单次忽略排除设置，用于验证文件是否存在。
工作区设置和用户设置哪个优先级高？
工作区设置 (.vscode/settings.json) 优先级高于用户设置。建议在工作区配置排除规则，避免影响其他项目的全局搜索体验。
参考来源
- Visual Studio Code Documentation - Settings
- Visual Studio Code Documentation - Code Search Guide