当前位置：首页 > 文章列表 > 文章 > 软件教程 > VS Code 怎样把多根工作区保存为项目文件

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

来源：17golang原创 2026-10-29 00:22:49 0浏览收藏

可以。先把两个或更多项目文件夹加入同一个多根工作区，再执行 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 会把它显示成新的根目录；继续添加即可形成多根工作区。

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

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

原创操作示意图，VS Code 多根工作区中并列显示 api-service 和 docs-site 两个根文件夹 — 图1：操作示意图，多个项目文件夹以并列根目录出现在同一工作区。

使用 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 等字段是额外能力，不是保存多根工作区的最低要求。