vscode 默认搜索因全量扫描导致效率低，vscode-crosside-code-finder 通过可保存的 finder 查询语句解决，支持路径白名单、文件类型、内容正则等条件组合，并提供可视化编辑与 json 共享。
为什么默认搜索在复杂目录里总找不到关键代码
因为 VSCode 内置的 Ctrl+Shift+F 是“全量扫描”，它不区分业务逻辑层和构建产物，也不理解你项目里的模块边界。一旦项目里有 node_modules、dist、.git 或自定义的 logs/、cache/，搜索就会卡顿、返回大量噪音结果，甚至超时失败。
这不是你电脑慢，是搜索范围没收敛。真正需要的不是“找所有含某字符串的文件”，而是“在 src/api 和 src/services 下，找调用了 useAuthStore() 的 .ts 文件，排除 test 目录”。这种需求，原生搜索靠手动输 glob 模式根本没法复用。
- 每次换场景都要重输排除路径，容易漏写或写错通配符
-
search.exclude是全局或工作区级配置，无法按“功能模块”动态切换 - 无法组合条件：比如“只查 Vue 组件里的
onMounted调用，且该组件名包含 user”
vscode-crosside-code-finder 怎么解决这个问题
它把搜索变成“可保存的查询语句”。每个 Finder 就是一组预设规则，包括路径白名单、文件后缀、内容正则、是否递归等。你可以建一个叫 api-calls 的 Finder，固定包含：src/api/**/*.{ts,js}，排除 **/mocks/**，搜索内容为 api.w+(；再建一个 vue-lifecycle Finder，限定 src/views/**/*.{vue,tsx}，搜 onMounted|onUnmounted。
- Finder 可一键执行，不用反复填搜索框
- 支持 JSON 配置导出/导入，团队内共享统一搜索习惯
- 比正则更友好：提供可视化条件编辑器（路径过滤、文件类型勾选、内容关键词输入）
- 不依赖索引，直接走文件系统遍历，结果实时准确，无缓存偏差
和 Markdown 目录插件一样，也要注意“生成位置”和“更新时机”
很多人装了 Markdown All in One 却发现目录点不动，问题常出在锚点生成逻辑上：标题含中文或特殊符号时，VSCode 默认转义规则是 #简介 → #简介，但有些插件会转成 #%E7%AE%80%E4%BB%8B，导致链接失效。同理，vscode-crosside-code-finder 的路径匹配也依赖 VSCode 对 glob 模式的解析一致性。
- 路径中避免使用
\（Windows），一律用/或** - 排除路径如
**/test/**会同时屏蔽src/test/utils.ts和packages/core/test/，确认这是你想要的粒度 - 如果项目用了 pnpm 的 symlink 方式链接包，需开启
search.followSymlinks: true，否则跨 workspace 的调用搜不到
别忽略插件安装路径对调试的影响
当你发现 Finder 配置不生效，或者命令面板里找不到 Crosside: Run Finder，先检查插件是否真装进去了。VSCode 插件不是“点安装就完事”，它实际解压到 .vscode/extensions/ 下某个子目录，而这个路径在不同系统下差异很大：
- macOS：
/Users/xxx/.vscode/extensions/jinghaihan.vscode-crosside-code-finder-1.2.3/ - Linux：
/home/xxx/.vscode/extensions/jinghaihan.vscode-crosside-code-finder-1.2.3/ - Windows：
C:Usersxxx.vscodeextensionsjinghaihan.vscode-crosside-code-finder-1.2.3
如果手动删过扩展目录、或用脚本批量清理过 .vscode/extensions，很可能把 Finder 删没了却没重装——它不像核心插件那样被自动恢复。打开命令面板执行 Developer: Open Extensions Folder，进去看有没有对应文件夹，比重启 VSCode 更快定位问题。
