多根工作区中 .vscode/settings.json 优先级高于 .code-workspace 的 settings 字段,每个子文件夹的该文件独立生效;.code-workspace 中的 settings 仅作为未被子项目覆盖时的兜底配置,适用于 search.exclude 等跨根通用设置。

多根工作区里 .vscode/settings.json 不生效?先确认作用域层级
VSCode 的设置优先级是「工作区 > 用户」,但这个「工作区」在多根场景下有歧义:它不指整个 .code-workspace 文件,而是指每个独立的文件夹根目录下的 .vscode/settings.json。也就是说,.code-workspace 本身不能直接放 settings.json,它只管顶层 settings 字段(覆盖全局)、folders 和调试/任务配置。
常见错误现象:.code-workspace 里写了 "editor.tabSize": 2,但某个子项目里的 .vscode/settings.json 又设了 "editor.tabSize": 4,结果发现编辑器用的是 4 —— 这不是 bug,是预期行为:子文件夹的 .vscode/settings.json 优先级高于 .code-workspace 的 settings 字段。
- 想统一所有子项目的缩进、换行符等基础规则,必须在每个子项目根目录下手动创建并维护
.vscode/settings.json -
.code-workspace中的settings字段只影响“未被子项目显式覆盖”的项,适合写兜底值或跨项目通用开关(如"search.exclude") - 如果某个子项目没建
.vscode目录,它才会真正继承.code-workspace的settings
.code-workspace 里怎么安全配置 files.exclude 和 search.exclude
这两个配置是少有的、适合放在 .code-workspace 顶层 settings 中的字段,因为它们天然需要跨文件夹生效:比如你希望在整个工作区里都隐藏 node_modules、dist 或特定日志目录,而不是逐个子项目去配。
关键点在于路径写法:必须用相对于各子项目根目录的相对路径,不能用绝对路径或 workspace-relative 变量(如 ${workspaceFolder} 在这里不支持)。
- 正确写法:
"search.exclude": { "**/node_modules": true, "**/logs": true } - 错误写法:
"search.exclude": { "/full/path/to/node_modules": true }(绝对路径无效) - 错误写法:
"search.exclude": { "${workspaceFolder}/dist": true }(变量不解析) - 注意:这种排除仅影响搜索和资源管理器显示,不影响文件系统本身;若某子项目需额外排除,仍可在其
.vscode/settings.json中叠加
隐藏文件(如 .env、.gitignore)在多根工作区里为何有时不显示?
VSCode 默认不隐藏这些文件,但如果你发现它们“突然消失”,大概率是某个子项目的 .vscode/settings.json 或 .code-workspace 的 settings 字段里误加了 "files.exclude",且用了模糊匹配。
典型陷阱:"files.exclude": { "**/*.env": true } 看似只隐藏 .env,实际会把所有带 .env 后缀的文件(如 .env.local、.env.production)全干掉,而且该规则会穿透到所有子项目。
- 修复方法:检查每个子项目的
.vscode/settings.json和.code-workspace文件,搜files.exclude - 更安全的写法:
"files.exclude": { "**/.env": true, "**/.env.*": true }(显式列出变体) - 如果只想在资源管理器中折叠而非隐藏,改用
"explorer.compactFolders": false配合手动折叠,别动files.exclude
为什么 .vscode 目录本身在资源管理器里不可见?
这不是配置问题,是 VSCode 的硬编码行为:.vscode 目录默认对用户完全隐藏,无论你在哪一级设置 files.exclude 都无法让它“重现”。这是为了防止误操作破坏工作区配置。
但你可以通过以下方式间接确认它存在:
- 终端进入任意子项目根目录,执行
ls -a(macOS/Linux)或dir /ah(Windows),能看到.vscode - 在 VSCode 中按
Ctrl+P(或Cmd+P),输入.vscode/settings.json,文件会直接打开(即使不显示在侧边栏) - 右键资源管理器空白处 → “在资源管理器中显示隐藏的文件” 无效 —— 这个菜单项只管用户级隐藏文件,不管
.vscode
真正的麻烦点在于:当你用脚本批量初始化多根工作区时,容易漏掉为每个子项目生成 .vscode 目录;而 VSCode 不会自动创建它,哪怕你写了 .code-workspace 的 settings 字段。这一步必须人工或脚本补全。


















