vscode-crosside-code-finder 解决复杂项目中内置搜索“找不到、找不准、反复配”的问题，通过可复用、作用域隔离的自定义查找器，精准限定路径、文件类型、大小写及正则匹配规则。
vscode-crosside-code-finder 能解决什么问题
它不是替代 Ctrl+P 或 Ctrl+Shift+F，而是补上这两个快捷键在复杂项目里“找不到、找不准、反复配”的短板。比如你在 monorepo 里想查 useAuthStore 在哪些 .ts 文件里被 import，但不想扫 node_modules、dist、e2e 目录，也不希望结果混着测试文件——这时候内置搜索要么得手敲一堆 !file:*.spec.ts，要么漏掉路径约束，而这个插件让你把规则存成一个“查找器”，点一下就执行。
怎么配置一个只搜 src/api 下 .ts 文件的查找器
安装插件后，按 Ctrl+Shift+P 输入 Code Finder: Create New Finder，会生成一个 JSON 配置模板。关键字段填法如下：
-
"include": ["${workspaceFolder}/src/api/**/*.ts"]—— 白名单路径，只搜这里，不递归其他目录 -
"exclude": ["**/test/**", "**/*.d.ts"]—— 黑名单，比search.exclude更细粒度，且仅对当前查找器生效 -
"caseSensitive": false—— 小写匹配更稳妥，避免因命名风格不一致漏结果 -
"regex": true—— 开启后可在搜索词里用\buseAuthStore\b确保是独立标识符，不是子串
保存后，右键任意文件 → “Run Finder on This File” 或从命令面板调用，就能复用这套逻辑。
为什么不能直接改 search.include / search.exclude
全局或工作区级的 search.include 是静态白名单，一旦设死，所有 Ctrl+Shift+F 都受限；而 search.exclude 是黑名单，容易误杀（比如你排除了 **/mock/**，但某天想专门搜 mock 数据）。vscode-crosside-code-finder 的每个查找器是独立作用域，互不干扰——你可以在同一个项目里同时存在“搜 hooks”、“搜 legacy 组件”、“搜 error handler”三个查找器，各自路径、文件类型、大小写策略全不同，切换成本为零。
容易被忽略的兼容细节
这个插件依赖 VSCode 的底层搜索服务，所以它不支持跨工作区（multi-root）时的“跨文件夹联合搜索”；另外，如果项目用了符号链接（symlinks），默认不会跟随，需要手动在查找器里加 "followSymlinks": true。还有个坑：插件的正则引擎用的是 PCRE2，但部分语法（如 (?i) 内联标志）在某些 VSCode 版本里会失效，建议统一用 "caseSensitive": false 控制，别塞进正则表达式里。
