vscode-crosside-code-finder 解决大型项目中跨目录精准搜索的痛点，支持白名单式多路径包含、可复用命名配置、排除规则及正则内容匹配，避免传统搜索范围过大或漏配问题。
vscode-crosside-code-finder 能解决什么实际问题
它不是另一个“增强搜索框”的插件，而是把目录结构本身变成可查询的对象。当你在大型项目里找 useAuthStore 的调用点，但不确定它在 src/stores 还是 packages/auth 时，传统搜索会扫完整个工作区，而这个插件允许你直接定义：“只查 src/ 和 packages/auth/ 下的 .ts 和 .tsx 文件，排除所有 __tests__ 和 node_modules”。
常见错误现象：手动输入 **/src/**/useAuthStore 到搜索框，结果漏掉 packages/ 下的同名 hook；或者开了正则却忘了加 i 标志，导致大小写不匹配。
- 使用场景：微前端项目中跨多个 package 查 hooks 或 composables
- 参数差异：内置搜索的
files to include是单次输入，而该插件的 Finder 是保存好的配置，可复用、可命名、可共享 - 性能影响：它不重建索引，而是复用 VSCode 原生搜索能力，但通过预过滤路径大幅减少文件 I/O 次数
如何配置一个「只搜 src/views 下所有 .vue 文件」的 Finder
安装插件后，按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P），输入 Finder: Create New Finder，回车。
接下来填三项：
-
Name：比如填views-vue -
Include pattern：填src/views/**/*.vue（注意不是**/src/views/**/*.vue，前者更准） -
Exclude pattern：填src/views/**/__tests__/**, src/views/**/test/**（用英文逗号分隔）
保存后，以后只需按 Ctrl+Shift+P → Finder: Run views-vue，就自动跳转到限定范围的搜索面板，files to include 栏已预填好，不用再手输。
为什么不能只靠 search.exclude 配置
search.exclude 是全局或工作区级的黑名单，它只能“排除”，不能“主动指定包含哪些目录”。比如你设了 "**/dist": true，它对所有搜索生效，但如果你某次只想查 dist 里的打包产物内容，就得临时删配置、搜完再改回去——这很反直觉。
vscode-crosside-code-finder 的 Finder 是白名单思维：每次明确说“我要查哪几块”，其余默认不碰。这对多环境、多模块项目特别关键。
- 容易踩的坑：把
Include pattern写成相对路径如./src/views，VSCode 不识别，必须用 glob 形式（src/views/**） - 兼容性注意：VSCode 1.96+ 版本下，Finder 的路径解析更严格，
**/src/views/**可能匹配到packages/mylib/src/views，应优先用src/views/**
和右键「Find in Folder」比有什么不可替代性
右键 Find in Folder 确实快，但它只支持单目录，且不能组合条件。比如你要查 “在 src/components 和 src/layouts 中，所有调用了 api.fetchUser 的 .tsx 文件”，就必须分别右键两次、手动合并结果、再人工去重。
而一个 Finder 可以同时写多个 include 模式：
src/components/**/*.tsx, src/layouts/**/*.tsx
还能叠加内容正则：api\.fetchUser\(\)，并勾选“Use Regular Expression”——这些都是一键执行的。
真正复杂的地方在于路径语义的歧义：VSCode 对 ** 的展开依赖当前工作区根目录，而 Finder 的每个 pattern 是独立解析的。如果工作区开了多根文件夹（multi-root workspace），务必确认每个 pattern 对应的根是否一致，否则会出现“明明写了路径却没结果”的静默失败。
