VS Code 怎样把多根工作区保存为项目文件

可以。先把两个或更多项目文件夹加入同一个多根工作区，再执行 File > Save Workspace As...，选择保存位置并保留 .code-workspace 扩展名。保存后的项目文件记录根文件夹，之后可以用 File > Open Workspace 或最近打开记录恢复整个工作区。

官方地址：https://code.visualstudio.com/docs/editing/workspaces/multi-root-workspaces

这篇只处理“把当前多根工作区保存成项目文件”这一个任务。判断是否成功，不看窗口标题是否变化，而是重新打开保存出的文件，确认 Explorer 中的根文件夹数量、名称和层级都恢复。

把多个文件夹加入同一个工作区

如果当前窗口只打开了一个文件夹，先从菜单执行 File > Add Folder to Workspace...，在文件选择框中选中第二个项目。添加后，Explorer 会把它显示成新的根目录；继续添加即可形成多根工作区。

1. 打开第一个项目文件夹。
2. 选择 File > Add Folder to Workspace...。
3. 选择第二个项目文件夹，确认 Explorer 中出现两个并列根目录。
4. 需要调整顺序时，直接在 Explorer 中拖动根文件夹；不需要的根目录可用右键菜单移除。

这里的关键状态是“并列根目录”，而不是把一个项目文件夹拖进另一个项目内部。VS Code 官方文档把这种窗口称为 multi-root workspace；未保存前，它可能显示为未命名工作区，生命周期通常跟当前 VS Code 实例绑定。

使用 Save Workspace As 保存为项目文件

确认根目录已经齐全后，选择 File > Save Workspace As...。在保存对话框中选择团队项目常用的位置，文件名可以写成 team-project.code-workspace。扩展名很重要，它让 VS Code 能把这个文件识别为工作区文件。

保存位置最好与项目有稳定的相对关系。如果工作区文件需要和项目一起交给其他人，使用相对路径更容易迁移；如果只是个人临时整理多个不相关项目，也可以按自己的目录习惯保存。保存之后，Explorer 中通常会显示工作区文件名，窗口也不再只是一个未命名工作区。

保存动作本身不会把多个项目合并成一个目录，也不会复制项目源代码。它保存的是“哪些文件夹属于这个工作区”以及可选的工作区级配置。

检查 .code-workspace 文件里保存了什么

可以在系统文件管理器中打开刚保存的文件，或者通过 VS Code 的工作区配置入口查看。一个简化的工作区文件可以写成下面这样。它使用 JSONC 形式，因此示例中的中文注释只用于解释字段；真正交给严格 JSON 解析器时应去掉注释。

{
  // folders 保存多根工作区中的项目文件夹
  "folders": [
    {
      // 相对路径便于把工作区文件随项目移动
      "path": "api-service",
      "name": "API 服务"
    },
    {
      // 第二个根目录与第一个根目录并列
      "path": "docs-site",
      "name": "文档站点"
    }
  ],
  // settings 是整个工作区共享的可选设置
  "settings": {
    "files.autoSave": "afterDelay"
  }
}

最重要的是 folders 数组：每个元素代表一个根文件夹，path 可以是绝对路径或相对路径，name 则可以只改变 Explorer 中的显示名称。settings、tasks 和 extensions 等字段是额外能力，不是保存多根工作区的最低要求。

重新打开并核对保存结果

关闭当前工作区后，选择 File > Open Workspace... 并打开刚才的 .code-workspace 文件，也可以从 File > Open Recent 中选择带有 (Workspace) 标记的项目。

重新打开后按下面三点核对：

• Explorer 中恢复了原来的全部根文件夹，而不是只打开其中一个目录。
• 根文件夹的显示名称和保存前一致；如果使用了 name 字段，显示名称可以与实际目录名不同。
• 打开工作区文件后，编辑器能够定位相对路径；如果文件被移动到另一处，检查项目文件夹是否也按相对关系移动。

保存不生效时先看这几个边界

仍然显示未命名工作区：通常是还没有执行 Save Workspace As，或者保存对话框被取消。重新执行保存，并确认磁盘上确实出现以 .code-workspace 结尾的文件。

重新打开后只剩一个项目：检查打开的是项目文件夹还是工作区文件。应使用 Open Workspace 打开 .code-workspace，不要在文件管理器中直接双击其中一个项目目录。

换电脑后路径失效：优先把工作区文件放在多个项目的共同父目录下，并使用相对路径。绝对路径虽然能工作，但换机器、换用户或调整目录后需要重新添加根文件夹。

常见问题

多根工作区保存后会不会复制项目文件？
不会。.code-workspace 主要保存根文件夹路径和可选的工作区配置，源代码仍在原来的项目目录中。

只打开一个文件夹时也要保存 .code-workspace 吗？
不一定。单文件夹项目直接打开目录即可；只有需要同时管理多个根文件夹，或希望把工作区级设置与团队共享时，保存工作区文件才有明显价值。