VS Code 的 Ctrl+P 卡顿主因是默认递归扫描全工作区路径，遇 node_modules 等大目录时文件系统调用阻塞；应启用 ripgrep、正确配置 search.exclude（如 "/node_modules/"）、排除符号索引及无关子目录，并检查系统索引状态。
为什么 VS Code 的文件名搜索（Ctrl+P）会卡顿
根本原因不是 VS Code 本身慢，而是它默认对整个工作区递归扫描所有文件路径，尤其当项目里混着 node_modules、dist、.git 或大型二进制资源时，每次按键都在实时遍历成千上万个路径。这不是 UI 卡，是底层文件系统调用被拖住。
实操建议：
- 立刻在设置中启用
"search.useRipgrep": true（VS Code 1.80+ 默认开启，老版本务必手动开）——它用原生rg替代 JS 实现的搜索，速度提升 5–10 倍 - 检查是否意外禁用了
"search.followSymlinks": false，符号链接环路会导致无限遍历 - 确认没有在设置里把
"search.exclude"写成正则但忘了加**/前缀，比如写"node_modules"不生效，得写"**/node_modules"
如何精准排除干扰目录（不是靠 guess）
很多人改完 search.exclude 发现还是慢，是因为只排除了目录名，没覆盖其子路径；或者用了通配符但语法错，VS Code 就自动降级回慢搜。
实操建议：
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到 Console 标签，输console.log(require('vscode').workspace.getConfiguration('search').exclude)，看实际生效的排除规则 - 排除规则必须写全路径模式：
"**/node_modules/**"（结尾/**表示递归排除子目录）、"**/.git/**"、"**/build/**" - 避免用
"**/logs/*"这种写法——*不匹配斜杠，logs/a/b.txt仍会被扫；应写"**/logs/**"
大单体项目下 Ctrl+P 依然卡？试试 workspace 级过滤
当项目本身结构复杂（比如含多个子模块、跨语言），光靠 search.exclude 不够，因为 Ctrl+P 默认仍要列出所有顶层目录下的文件。这时候得让 VS Code “只看我关心的目录”。
实操建议：
- 创建
.vscode/settings.json，加入："files.watcherExclude": { "**/node_modules/**": true, "**/dist/**": true }——这能减轻文件变更监听压力，间接加快 Ctrl+P 初始化速度 - 在
settings.json中设"search.quickOpen.includeSymbols": false，关掉符号索引（否则每次打开 Ctrl+P 都要等 TS/JS 语言服务吐出符号表） - 如果项目允许，把无关子目录从 workspace 中移除：右键资源管理器里的文件夹 →
Remove Folder from Workspace，不是删除磁盘文件
Mac / Windows 下特别慢？检查文件系统权限和索引状态
macOS 上 Spotlight 或 Windows 上 Windows Search 若被 VS Code 调用（尤其旧版），可能因权限不足或索引损坏导致超时 fallback 到慢路径扫描。
实操建议：
- Mac 用户：终端执行
mdutil -s查当前索引状态，若显示Indexing disabled，运行sudo mdutil -i on /开启（需密码） - Windows 用户：打开“索引选项”，确认工作区所在磁盘已加入索引位置；若用 WSL，别把项目放
/mnt/c/下——跨文件系统访问极慢，应放~/project内 - VS Code 设置中关闭
"search.useGlobalRipgrep": false（默认值），强制用内置rg，避免调外部命令失败后退化
真正卡住的时候，往往不是配置没写对，而是某一层排除规则语法错、某个目录软链形成死循环、或者文件系统索引压根没建好——先查 DevTools 控制台报什么，再动配置。
