VSCode工作区是什么_多项目管理与工作区配置教程

.code-workspace 是可编程的多项目开发上下文快照，需先添加文件夹再保存；配置分三层优先级，推荐插件须放工作区根目录的 .vscode/extensions.json；调试需用 compound 分层定义 launch.json。

.code-workspace 文件不是“打开多个文件夹”的快捷方式，而是你主动定义的多项目开发上下文快照——它能记住你加了哪些项目、每个项目叫什么、缩进用几个空格、哪些插件该启用、甚至上次关掉时终端在跑什么命令。

直接用 File → Open Folder 打开单个目录，所有配置都只作用于那个文件夹，且不保存；而保存为 .code-workspace 后，VSCode 就知道：“这是前端+后端+共享库联调专用环境”，下次双击就能原样恢复。

怎么创建一个真正可用的多根工作区

别先点“将工作区另存为…”——那会生成一个空壳。正确顺序是：先加项目，再保存。

• 启动干净的 VSCode（不打开任何文件夹）
• 点击 文件 → 将文件夹添加到工作区…，依次选中 frontend/、backend/、shared-lib/
• 确认资源管理器顶部已列出全部三个文件夹
• 再执行 文件 → 将工作区另存为…，命名为 my-app.code-workspace

此时生成的 JSON 文件里会包含 folders 数组，路径默认是相对工作区文件所在位置的——比如你把 .code-workspace 放在 ~/projects/ 下，那 "path": "frontend" 就指向 ~/projects/frontend。路径写错会导致打开时报错 Folder does not exist。

settings.json 放哪儿？优先级怎么算？

VSCode 设置有三层：用户级（全局）→ 工作区级（.code-workspace 里的 settings 字段）→ 文件夹级（各项目根下的 .vscode/settings.json）。越靠近项目，优先级越高。

• 统一规则（如禁用 node_modules 搜索）写进 .code-workspace 的 settings
• 项目特有规则（如 python.defaultInterpreterPath 只对后端生效）必须放 backend/.vscode/settings.json
• 千万别把敏感值（如 API Token、ssh 密钥路径）写进 .code-workspace——它常被提交到 git

{   "folders": [     { "path": "frontend" },     { "path": "backend" }   ],   "settings": {     "search.exclude": {       "**/node_modules": true,       "**/dist": true     },     "editor.tabSize": 2   } }

为什么推荐扩展没弹出来？

VSCode 只在工作区根目录下发现 .vscode/extensions.json 时才提示安装推荐插件。但很多人误把它放在 .code-workspace 同级，或写错字段名。

• 必须建在工作区根目录（即和 my-app.code-workspace 同一目录），路径是 .vscode/extensions.json
• 内容只能是标准 JSON，且字段名必须是 recommendations，不是 recommended 或 extensions
• 插件 ID 要准确，比如 Prettier 是 esbenp.prettier-vscode，不是 prettier.vscode

{   "recommendations": [     "esbenp.prettier-vscode",     "ms-python.python",     "rust-lang.rust-analyzer"   ] }

调试前端+后端时 launch.json 总冲突？

根本问题在于：VSCode 默认把所有 .vscode/launch.json 当作同一套配置加载。解决方法是分层——工作区级定义 compound，子项目级各自写独立 launch.json。

• 在 frontend/.vscode/launch.json 中定义 chrome 启动配置，"name": "Frontend Dev Server"
• 在 backend/.vscode/launch.json 中定义 node.js 启动配置，"name": "Backend API"
• 在工作区根目录（非任何子项目内）新建 .vscode/launch.json，只写 compounds：

{   "version": "0.2.0",   "compounds": [     {       "name": "Full Stack Debug",       "configurations": ["Frontend Dev Server", "Backend API"],       "preLaunchTask": "Start Backend"     }   ] }

这样 VSCode 才知道：“先跑后端任务，再并行启动两个服务”。否则它会在所有子项目里乱找 launch 配置，报错 Cannot find the configuration 'xxx'。

真正的难点不在“怎么加文件夹”，而在于理解 .code-workspace 是一个可编程的上下文容器——它不保存代码，但保存意图；不替代 Git，但能减少团队成员之间因“我这好使，你那不行”产生的扯皮。路径、命名、层级、信任状态（Trust Settings），每一步松动都会让协作成本悄悄翻倍。