VSCode通过.code-workspace文件支持多项目并行编辑，它可跨磁盘路径声明多个根文件夹，统一管理配置、任务与调试环境，且不污染项目目录；而直接打开文件夹仅为单文件夹工作区，设置保存在.vscode/settings.json中。
VSCode 本身不支持传统意义上的“多项目并行编辑”，但通过 工作区（Workspace） 可以高效组织多个相关文件夹、配置和任务——这不是简单打开多个窗口，而是让一组项目共享一套设置、扩展行为和调试上下文。
什么是 .code-workspace 文件，它和直接打开文件夹有啥区别？
直接打开一个文件夹时，VSCode 创建的是「文件夹工作区」，所有设置保存在该文件夹下的 .vscode/settings.json 中；而 .code-workspace 是一个独立的 JSON 文件，显式声明多个根文件夹，并可覆盖全局/文件夹级配置。
关键区别在于：
-
.code-workspace支持跨磁盘路径（比如同时包含C:/proj/backend和D:/proj/frontend） - 它能统一管理
tasks、launch、extensions推荐列表（extensions.recommendations） - 关闭后重新打开，会还原所有已打开的编辑器标签和终端会话（前提是没勾选「在新窗口中打开」）
- 它不会污染任一项目目录——
.code-workspace文件可放在任意位置，比如专门建个~/workspaces/目录统一管理
如何正确添加多个文件夹到一个工作区？
别用「文件 → 添加文件夹到工作区」反复点——这容易误操作成嵌套子文件夹或重复添加。推荐方式是手动编辑 .code-workspace 文件：
先通过「文件 → 将工作区另存为…」生成一个基础文件，然后用文本编辑器打开它，修改 "folders" 数组：
{
"folders": [
{ "path": "../my-api" },
{ "path": "../my-web" },
{ "path": "../shared-utils" }
],
"settings": {
"editor.tabSize": 2,
"files.exclude": { "**/node_modules": true }
}
}
注意：
- 路径是相对于
.code-workspace文件所在位置的相对路径，不是绝对路径（除非你明确写"path": "/full/path/to/project"） - 不要在
"folders"里混用相对和绝对路径，VSCode 会报错Invalid workspace configuration: folder path must be a string - 如果某个文件夹暂时不想加载，可以加
"mask": true字段（VSCode 1.86+ 支持），它仍显示在资源管理器中但不索引文件、不触发文件监听
工作区设置（settings）怎么优先级生效？
VSCode 设置有明确优先级链：全局 .code-workspace .vscode/settings.json。但很多人踩坑在以为工作区设置能覆盖所有子文件夹——其实不能。
例如你在 .code-workspace 里写了 "eslint.enable": false，但某个子文件夹里有 .vscode/settings.json 写了 "eslint.enable": true，那这个文件夹仍会启用 ESLint。
真正想「强制统一」某些行为，得用：
-
"settings"下加"[javascript]": { "editor.formatOnSave": true }这类语言专属配置 - 把共用配置抽成
.vscode/settings.json放在每个子项目根目录（配合脚本同步） - 用
"settings"+"files.watcherExclude"避免某文件夹触发大量文件系统事件（比如"**/dist/**"）
为什么我的工作区终端总在第一个文件夹下启动？
VSCode 终端默认继承「活动编辑器所在文件夹」的 cwd（当前工作目录）。如果你没打开任何文件，它就取 "folders" 数组里的第一个路径。
解决办法很直接：
- 右键资源管理器里的某个文件夹 → 「在集成终端中打开」
- 快捷键
Ctrl+Shift+P→ 输入Terminal: Create New Terminal (In Active Workspace Folder) - 在
.code-workspace的"settings"里加"terminal.integrated.defaultProfile.windows": "Git Bash"等，只改 shell 类型，不改路径
没有「为每个文件夹绑定独立默认终端」的内置机制——这是设计限制，不是 bug。如果真需要隔离环境（比如不同项目用不同 Node 版本），得靠 direnv 或 nvm use 这类 Shell 层工具，在终端启动时自动切换。
