VSCode中配置自定义搜索路径以提高效率-VSCode-PHP中文网

search.include 仅对当前工作区生效，必须配置在项目级 .vscode/settings.json 中；全局 settings.json 无效，且值必须为 true（非字符串），路径需用 ${workspacefolder}。

vscode中配置自定义搜索路径以提高效率

search.include 只对当前工作区生效，别往全局 settings.json 里写

想让某个项目只搜 src 和 include 目录？必须把配置放在那个项目的 .vscode/settings.json 里。写进用户级的 settings.json（比如 %APPDATA%\Code\User\settings.json）完全无效——search.include 不支持全局覆盖，它只响应工作区设置。

常见错误现象：改完全局配置，Ctrl+Shift+F 还是扫完整目录，甚至报错 Invalid configuration for "search.include"。

search.include 的键必须是 glob 路径，值只能是 true（不能写 "true" 字符串）
路径里用 ${workspaceFolder}，别硬编码绝对路径（如 D:/Projects/MyApp/src/**），否则换机器就失效
如果同时设了 search.exclude 和 search.include，前者优先级更高——排除规则会先执行，再从剩余范围里按 include 筛选

search.exclude 和 files.exclude 的作用完全不同，别混用

search.exclude 只影响 Ctrl+Shift+F 的全局搜索；files.exclude 控制资源管理器里“看不见哪些文件”，也间接影响搜索（因为被隐藏的文件根本不会被索引）。两者都用 glob，但生效场景不同。

容易踩的坑：

只配 files.exclude 却没配 search.exclude：资源管理器里看不到 node_modules，但 Ctrl+Shift+F 还是会扫它（尤其当你没关 search.useIgnoreFiles 时）
误把 **/dist 写成 /dist：后者只排除根目录下的 dist，而前者才匹配所有层级
search.exclude 里加 "**/*.log": true 有效，但 "*.log": true 只匹配当前目录下的 log 文件，深层日志仍会被搜到

多根工作区下，每个文件夹要单独配 .vscode/settings.json

VS Code 打开多根工作区（多个文件夹并列）时，每个子文件夹的搜索行为是独立的。你不能指望在最外层建一个 .vscode/settings.json 统管全部——它只对“最外层工作区”本身生效，子文件夹默认继承全局设置。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

正确做法：

进入每个子文件夹（比如 frontend/、backend/），分别创建自己的 .vscode/settings.json
在 frontend/ 里配 "search.include": {"${workspaceFolder}/src/**": true}
在 backend/ 里配 "search.include": {"${workspaceFolder}/app/**": true, "${workspaceFolder}/lib/**": true}
别偷懒用 ${workspaceFolder:frontend} 这种变量——它只在终端 terminal.integrated.cwd 里有效，search.include 不认