Cursor 忽略 node_modules 需修改 settings.json 配置 search.exclude 和 files.watcherExclude，因 Cursor 基于 VSCode 架构，继承其文件监听与搜索机制。直接排除该目录可减少索引负载，但需确保 glob 模式写法正确，否则配置不生效。
先说结论：Cursor 通过 VSCode 兼容的设置项控制文件索引，正确配置排除规则可显著降低资源占用。
- 适合场景：大型前端项目、依赖包体积大、搜索响应慢或 CPU 持续高占用。
- 先做配置：在 settings.json 中写入 search.exclude 和 files.watcherExclude 规则。
- 再验证：执行全局搜索确认无 node_modules 结果，观察后台进程负载。
快速处理思路
无需安装插件，直接编辑用户设置或工作区设置文件。核心是添加两条键值对，确保路径匹配模式为 glob 格式。
{
"search.exclude": {
"**/node_modules": true
},
"files.watcherExclude": {
"**/node_modules/**": true
}
}将上述代码片段合并至现有的 settings.json 文件中，保存后重载窗口即可生效。
为什么会这样
Cursor 默认索引工作区全量文件，node_modules 包含大量无需编辑的第三方代码。未排除时，文件监视器会持续监听该目录变化，搜索功能会遍历其中文本，导致 I/O 负担加重和索引速度下降。基于 VSCode 架构的编辑器均存在此机制，排除后可停止后台扫描。
分步处理
按以下顺序操作，确保配置写入正确位置且格式无误。
步骤 1：打开设置文件
快捷键 Ctrl+Shift+P (Mac 为 Cmd+Shift+P)，输入 Preferences: Open Settings (JSON)。选择用户设置 (User Settings) 影响所有项目，或工作区设置 (Workspace Settings) 仅影响当前项目。
步骤 2：写入排除规则
在 JSON 对象大括号内添加 search.exclude 和 files.watcherExclude 字段。注意逗号分隔，若已有其他配置项，需在上一行末尾补逗号。
步骤 3：重载窗口
配置保存后不会立即刷新文件监听状态。按 Ctrl+Shift+P，输入 Developer: Reload Window 并执行，强制重新加载配置。
怎么验证是否生效
通过搜索行为和系统资源两个维度确认配置已起作用。
搜索验证：按 Ctrl+Shift+F 打开全局搜索，输入 node_modules 中常见的包名（如 lodash）。若结果列表不显示 node_modules 路径下的文件，说明 search.exclude 生效。
监听验证：打开任务管理器或活动监视器，观察 Cursor 主进程 CPU 占用。在文件保存或切换时，若 CPU 无明显峰值，说明 files.watcherExclude 已停止监听该目录。
常见坑
配置无效通常由路径模式错误或键名混淆导致，排查时优先检查以下细节。
files.exclude 无效：files.exclude 仅控制资源管理器显示，不影响搜索和索引。必须使用 search.exclude 才能跳过全局搜索。
Glob 模式错误：键名必须带通配符。写成 "node_modules": true 无效，必须写成 "**/node_modules": true 以匹配嵌套层级。
缓存残留：修改配置后未重载窗口，旧索引仍保留。若验证失败，尝试删除项目根目录下的 .vscode/.search 文件夹强制重建索引。
常见问题
排除后无法跳转第三方库代码怎么办
排除仅影响索引和搜索，不影响手动打开文件。若需跳转，可临时注释配置或使用 Ctrl+P 直接输入文件名打开。
为什么配置了还是搜到 node_modules
检查是否写错了键名，或使用了 files.exclude。确认 glob 模式是否带 **/ 前缀，并执行 Reload Window 刷新缓存。
多根工作区如何单独配置
search.exclude 在多根工作区下按文件夹分别生效。若需屏蔽特定子包，需在对应子文件夹的 settings.json 中单独设置规则。
参考来源
- VSCode 怎么在搜索时排除 node_modules 文件夹过滤设置【方法】
- 如何在 VSCode 安装后设置文件夹排除规则以优化搜索性能
- VSCode 中文搜索速度慢？配置搜索排除文件夹减少负载【必看】