VSCode工作区的核心是.code-workspace文件，它通过JSON定义多根文件夹、项目级配置、扩展启用状态及任务，实现真正隔离的多项目管理，避免设置混用与Git状态干扰。
vscode 的工作区（workspace）不是“打开多个文件夹”那么简单，它是一套独立的配置、扩展启用状态和任务定义的集合。直接用 file → open folder 打开多个文件夹，只会叠加在同一个窗口里，所有设置混在一起，根本不算真正管理多个项目。
什么是 .code-workspace 文件？为什么不能只靠多窗口？
VSCode 的多项目管理核心是 .code-workspace 文件——它本质是一个 JSON 配置文件，明确声明了哪些文件夹属于这个工作区，并可覆盖全局或用户级设置（比如 "editor.tabSize"、"files.exclude"），还能单独启用/禁用扩展（通过 "extensions.disabledRecommendations" 或配合 settings.json 中的 "extensions.ignoreRecommendations"）。
只开多个窗口，每个窗口都继承用户设置，无法隔离项目级 lint 规则、调试配置、代码格式化偏好，甚至 Git 仓库状态也会互相干扰。
- 一个
.code-workspace文件可包含多个根文件夹（multi-root workspace），适合微服务、前后端分离等场景 - 它不替代项目本身的
.git或package.json，而是 VSCode 运行时的“上下文快照” - 文件路径必须为绝对路径（Windows 下注意反斜杠转义或使用正斜杠），否则重装系统或换机器后会失效
如何创建并正确保存 .code-workspace 文件？
不要手动新建 JSON 文件再填内容——容易漏字段或格式出错。正确流程是：先用 File → Add Folder to Workspace... 加入所有需要的根目录，然后执行 File → Save Workspace As...，输入名称（如 my-fullstack.code-workspace），保存到项目外的统一位置（例如 ~/vscode-workspaces/）。
生成的文件默认不含 settings 字段，需手动添加才能覆盖配置：
{
"folders": [
{
"path": "/Users/me/project/backend"
},
{
"path": "/Users/me/project/frontend"
}
],
"settings": {
"editor.tabSize": 2,
"eslint.enable": true,
"files.exclude": {
"**/node_modules": true
}
},
"extensions": {
"recommendations": ["dbaeumer.vscode-eslint"]
}
}
-
"extensions.recommendations"是推荐列表，不影响已安装扩展；真正控制启用状态需在 UI 中右键扩展 → “Disable (Workspace)” - 如果某项目必须禁用 Prettier，不能只删掉它，得在
settings.json中设"prettier.enable": false - 保存后，双击该文件即可启动对应工作区——VSCode 会自动识别并加载所有配置
工作区切换的三种可靠方式
频繁切换时，别依赖 File → Open Recent，它只记最近打开的文件夹，不区分工作区。优先用以下方式：
-
命令面板快捷切换：按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Workspaces: Open Workspace，选择已保存的.code-workspace文件 -
资源管理器右键菜单：在侧边栏空白处右键 →
Open Workspace from File...，定位到你的工作区文件 -
终端快速启动：在任意终端中运行
code /path/to/my-project.code-workspace，VSCode 会新开窗口（加-r参数可复用当前窗口）
注意：File → Close Workspace 不会关闭窗口，只是卸载当前工作区上下文；而 File → Close Window 才真正退出——很多人误以为关了窗口就清空了配置，其实缓存还在，下次打开同名文件夹仍会沿用旧设置。
settings.json 的层级陷阱与 override 原则
VSCode 设置有四层优先级：默认 .vscode/settings.json。但很多人不知道：工作区级的 settings.json（即 .code-workspace 中的 settings 字段）只能覆盖用户级设置，不能 override 文件夹级设置。
举例：若 frontend/.vscode/settings.json 设了 "editor.insertSpaces": false，那么即使你在 .code-workspace 里写 "editor.insertSpaces": true，最终生效的仍是 false。
- 想强制统一，要么删掉子文件夹里的
.vscode/settings.json，要么把所有项目级配置统一提到工作区层面 - 调试配置（
.vscode/launch.json）不受工作区 settings 影响，必须每个文件夹自己维护，或用compounds跨文件夹组合 - Git 相关设置（如
git.autoRepositoryDetection）建议放在工作区级，避免不同项目混用同一 Git 凭据或忽略规则
最易被忽略的是：工作区配置不会自动同步到 GitHub 或团队协作中——.code-workspace 文件本身要手动加入版本控制（尤其含共享调试/任务配置时），但记得剔除敏感路径或本地绝对路径（改用相对路径 + ./ 前缀，或用变量如 ${workspaceFolderBasename}）。
