工作区通过.code-workspace文件统一管理多项目配置,支持共享设置、调试任务及扩展推荐,实现团队环境一致与高效协作,适用于全栈或多模块开发场景。

VS Code 工作区(Workspace)不是简单地打开一个文件夹,而是一个能管理多个项目、共享设置和配置的开发环境。它通过一个 .code-workspace 文件保存一组文件夹路径以及工作区专属的设置,让你在复杂项目中更高效地组织代码。
工作区与普通文件夹的区别
当你直接打开一个文件夹时,VS Code 使用的是该文件夹下的 .vscode/settings.json 设置。而使用工作区时,你可以:
- 同时包含多个不相关的项目目录
- 为这组目录统一配置调试器、任务、扩展推荐等
- 让团队成员使用一致的编辑器行为
创建并保存工作区
操作很简单:
- 打开 VS Code,依次添加你需要的文件夹:文件 → 添加文件夹到工作区
- 调整顺序或删除不需要的目录
- 保存工作区:文件 → 另存为工作区…,输入名称如 my-project.code-workspace
之后双击这个文件就能一键恢复所有目录和配置。
配置工作区专用设置
在 .code-workspace 文件中可以写入 JSON 格式的设置,作用范围仅限当前工作区:
{
"folders": [
{ "path": "frontend" },
{ "path": "backend" }
],
"settings": {
"editor.tabSize": 2,
"eslint.enable": true,
"git.autofetch": true
},
"extensions": {
"recommendations": [
"ms-vscode.vscode-typescript-next",
"esbenp.prettier-vscode"
]
}
}
这样即使全局设置了 tabSize 为 4,在这个工作区里始终是 2,避免格式混乱。
实际使用建议
要真正发挥工作区的价值,注意以下几点:
- 把 .code-workspace 文件加入版本控制(尤其是团队项目),确保大家环境一致
- 配合 Settings Sync 功能时,工作区设置不会被同步,保持本地独立性
- 可以用工作区隔离不同技术栈的项目组合,比如 React + Node.js + Docker 环境
- 结合 Tasks 和 Launch Configurations 实现一键构建整套系统
基本上就这些。合理使用工作区,能大幅减少上下文切换成本,特别适合全栈开发或多模块协作场景。不复杂但容易忽略。










