search.exclude 仅对当前工作区内的文件生效,对工作区外路径(如主目录、未打开项目)完全无效;全局搜索不会扫描未加入工作区的任意路径,必须通过多根工作区或搜索面板临时排除才能覆盖外部目录。

search.exclude 对工作区外文件完全无效
VSCode 的 search.exclude 只作用于当前打开的工作区(即资源管理器里显示的根文件夹及其子目录),对工作区外的任意路径——包括用户主目录、插件目录、其他未打开的项目——都不起作用。哪怕你在用户级 settings.json 里写了 "**/.vscode/extensions": true,它也只在“当前工作区恰好包含该路径”时才可能生效,而这不是设计意图,属于误用。
真正能覆盖工作区外路径的,只有两种情况:
- 你手动把那个外部目录拖进 VSCode 当作多根工作区的一部分(此时它变成“工作区内”)
- 你通过搜索面板右上角的 «Files to exclude» 输入框临时填入绝对路径 glob(如
/home/user/.vscode/extensions/**),但该规则仅本次搜索有效,且需 VSCode 有对应路径读取权限
常见误操作:在用户设置里加 "**/Downloads/**": true,以为以后搜什么都跳过下载目录——实际毫无效果,因为 Downloads 不在任何工作区中。
全局搜索默认不扫描未打开的文件夹
VSCode 的 Ctrl+Shift+F 全局搜索,本质是“对当前工作区所有可访问文件做内容匹配”,不是操作系统级的全盘扫描。它不会主动遍历 ~/Desktop、C:\Users\Me\Documents 或任何未显式加入工作区的路径。
所以如果你搜到了工作区外的文件,只可能是以下原因:
- 该路径被意外纳入工作区:比如你打开了
/home/user这个父目录,而.vscode/extensions恰好在其子树中 - 插件主动注入了文件系统句柄(极少见,通常来自自定义文件系统扩展)
- 你用了
search.useGlobalIgnoreFiles并启用了全局.gitignore,但它仍只影响“已参与搜索的文件”,不扩大搜索边界
验证方式:关闭所有文件夹,只打开一个空窗口,执行搜索——结果必为空。这说明 VSCode 从不越界扫描。
想搜多个独立项目?必须用多根工作区
VSCode 不支持“一次搜索跨 N 个未关联的文件夹”。若你有 /a/project1、/b/project2、/c/lib 三个独立路径,又不想合并成单目录,唯一合规做法是创建多根工作区(File → Add Folder to Workspace...)。
这时要注意:
- 每个根目录下的
.vscode/settings.json中的search.exclude仅对该根生效;无配置则继承用户级设置 - 多根工作区下,
files.exclude和search.exclude仍各自独立控制“显示”和“搜索”,不能靠一个配置通吃 - 搜索面板右上角的 «Files to exclude» 输入框规则,会对整个多根工作区统一生效
别试图用 **/project1/**,**/project2/** 这种 glob 去匹配分散路径——glob 是路径模式,不是文件名模糊匹配,它无法跨挂载点或跨绝对路径前缀工作。
为什么你搜到了 ~/.vscode/extensions?
这不是 VSCode 主动扫描,而是你无意中把用户配置目录当作了工作区根。典型场景:
- 你在终端执行了
code ~/.vscode(或 Windows 下code %USERPROFILE%\.vscode) - 你用 VSCode 打开了用户主目录(
code ~),而.vscode/extensions是其子目录 - 某插件(如 Settings Sync)自动将配置目录添加为工作区根
解决方法很简单:关掉这个“错误的工作区”,重新用 code /path/to/real/project 打开正确路径。如果必须保留多根,就在对应根目录的 .vscode/settings.json 里加 "**/extensions": true,而不是指望全局配置兜底。
最易被忽略的一点:VSCode 不会告诉你“当前工作区包含哪些根”,只能靠资源管理器顶部的文件夹列表肉眼确认——那里显示几个文件夹,搜索就扫几个范围。


















