多人共用搜索排除规则需统一写入项目级.vscode/settings.json，禁用用户级配置；多根工作区用search.include按文件夹精准控制；排查“搜不到”须依次检查右上角临时排除框、工作区类型及search.usePCRE2设置。
怎么让多人共用的搜索排除规则不被覆盖
团队项目里，search.exclude 配置写在用户级 settings.json 里，每个人本地改一次就互相冲突。真正能统一的只有工作区级配置——必须落在每个项目的 .vscode/settings.json 中，且不能被 .gitignore 或编辑器插件意外绕过。
常见错误现象：A 同学加了 "**/dist/**": true，B 同学拉代码后搜不到 dist 里的调试临时文件，以为“配置没生效”，其实是自己本地用户设置里开了 "search.useIgnoreFiles": false，导致 .gitignore 里写的 /dist 被忽略，反而让 search.exclude 失效。
- 所有排除规则必须写进项目根目录下的
.vscode/settings.json，而不是用户设置 - 显式设置
"search.useIgnoreFiles": true（默认值），确保团队都尊重.gitignore；若项目需强制包含某些被 git 忽略的目录（如secrets/），才考虑设为false并单独补search.include - 避免用
files.exclude做搜索过滤——它只影响资源管理器显示，对Ctrl+Shift+F无效 - 提交前检查：打开搜索面板右上角 ⋯ → «Files to exclude»，确认该输入框为空；否则临时规则会覆盖工作区配置
多根工作区下如何让每个子项目按自己规则搜索
当一个 VSCode 窗口打开多个文件夹（比如 client/、server/、shared/），全局 search.exclude 会作用于全部子项目，但实际需求往往是：client 排除 node_modules，server 排除 venv，shared 不排除任何东西。
VSCode 不支持为每个文件夹单独配 search.exclude，但可以用 search.include 实现等效控制——它优先级更高，且支持 per-folder。
- 在
client/.vscode/settings.json中写："search.include": { "${workspaceFolder}/src/**": true, "${workspaceFolder}/lib/**": true } - 在
server/.vscode/settings.json中写："search.include": { "${workspaceFolder}/app/**": true, "${workspaceFolder}/migrations/**": true } -
search.include和search.exclude可共存，但include先匹配，未命中则再看exclude - 路径必须用
${workspaceFolder}，不能硬编码绝对路径，否则别人 clone 后失效
为什么队友搜得到、你搜不到？重点查这三处
不是代码不一样，是搜索上下文被悄悄改了。90% 的“搜不到”问题出在这三个地方，且顺序不能乱查：
- 打开搜索面板后，右上角 ⋯ → «Files to exclude» 输入框是否非空？哪怕只多了一个空格，整条规则都会静默失效或误匹配
- 当前窗口是单文件夹还是多根工作区？多根时，
Ctrl+Shift+F默认搜全部根目录；想只搜当前激活文件夹，得先点搜索面板左上角「…」→ «Select files to search in» → 手动选中该文件夹 - 检查
search.usePCRE2是否开启：关掉它，VSCode 用 JS 正则引擎，部分 Unicode 字符（如中文扩展 B 区）可能匹配失败；团队应统一设为true并写入.vscode/settings.json
CI/CD 流水线里验证搜索配置是否生效
搜索配置不是“写完就完”，它会影响开发效率，也该进自动化校验。最轻量的办法：用 VSCode CLI 模拟搜索行为，不依赖 GUI。
示例脚本（在 CI 中运行）：
code --status | grep "search.exclude" # 确认配置已加载 rg -g '!**/node_modules' -g '!**/dist' 'console.log' ./src || echo "warning: no matches found — maybe exclude rules too aggressive"
更稳妥的做法是，在项目 CI 脚本中执行：
- 用
vscode.commands.executeCommand('workbench.action.findInFiles', {...})启动搜索并捕获返回结果（需配合插件 API） - 或直接调用底层
ripgrep：VSCode 实际用的就是它，命令参数和search.exclude规则完全对应，可复用同一套 glob 表达式做断言 - 注意：CI 环境无 GUI，不能依赖搜索面板 UI 行为；一切判断必须基于命令行输出或 API 返回值
真正难的不是写几行配置，而是让所有人理解：VSCode 搜索不是“搜全项目”，而是“在一堆过滤器筛过之后的剩余文件里搜”。团队协作里，最易被忽略的是那个右上角的 «Files to exclude» 输入框——它不存配置、不进 Git、每次打开都是空的，但只要有人手滑输了一次，就会让整个团队的搜索行为突然不一致。
