VS Code 工作区是什么？

Visual Studio Code 工作区 是在 VS Code 窗口（实例）中打开的一个或多个文件夹的集合。在大多数情况下，您会打开一个文件夹作为工作区。但是，根据您的开发工作流程，您可以使用一种称为 多根工作区 的高级配置来包含多个文件夹。

工作区的概念使 VS Code 能够

• 配置仅适用于特定文件夹而非其他文件夹的设置。
• 保留仅在该工作区上下文中有效的 任务 和 调试器启动 配置。
• 存储和恢复与该工作区相关的 UI 状态（例如，已打开的文件）。
• 仅针对该工作区选择性地启用或禁用扩展。

在 VS Code 文档、问题和社区讨论中，您可能会看到“文件夹”和“工作区”这两个术语互换使用。可以将工作区视为一个项目根目录，它具有额外的 VS Code 知识和功能。

注意：也可以在没有工作区的情况下打开 VS Code。例如，当你从平台的文件菜单中选择一个文件来打开一个新的 VS Code 窗口时，你将不在工作区内。在这种模式下，VS Code 的某些功能会受限，但你仍然可以打开和编辑文本文件。

如何打开 VS Code “工作区”？

您可以使用文件 > 打开文件夹... 菜单打开工作区，然后选择一个文件夹。

或者，如果您从终端启动 VS Code，可以将文件夹路径作为 code 命令的第一个参数来打开。例如，使用以下命令通过 VS Code 打开当前文件夹 (.)

code .

单文件夹工作区

您无需进行任何额外操作，只需使用 VS Code 打开一个文件夹，它就会成为 VS Code 工作区。打开文件夹后，VS Code 会自动跟踪配置，例如您打开的文件或编辑器布局。当您在 VS Code 中重新打开该文件夹时，编辑器会恢复到您之前离开时的状态。

您还可以添加其他特定于文件夹的配置，例如工作区特定的 设置（与全局用户设置相对）、任务定义 和 调试启动 文件（参见下面的 工作区设置 部分）。

在 VS Code 中打开的单文件夹工作区

多根工作区

多根工作区 是 VS Code 的一项高级功能，允许您配置多个不同的文件夹作为同一工作区的一部分。您不是将一个文件夹作为工作区打开，而是打开一个 <name>.code-workspace JSON 文件，该文件列出了工作区的所有文件夹。例如

{
  "folders": [
    {
      "path": "my-folder-a"
    },
    {
      "path": "my-folder-b"
    }
  ]
}

在 VS Code 中打开的多根工作区

注意：打开文件夹与打开 .code-workspace 文件的视觉差异可能很细微。为了提示您已打开 .code-workspace 文件，用户界面的某些区域（例如文件资源管理器根目录）会在名称旁边显示额外的 (工作区) 后缀。

未命名多根工作区

您可以灵活地在工作区中添加或移除文件夹。首先在 VS Code 中打开一个文件夹，然后根据需要再添加更多文件夹。

文件资源管理器上下文菜单，用于在工作区中添加或移除文件夹

除非您已经打开了一个 .code-workspace 文件，否则当您第一次向工作区添加第二个文件夹时，VS Code 会自动创建一个未命名工作区。在后台，VS Code 会自动为您维护一个 untitled.code-workspace 文件，该文件包含您当前会话中的所有文件夹和工作区设置。工作区将保持未命名状态，直到您决定将其保存到磁盘。

在 VS Code 中打开的未命名多根工作区

注意：未命名工作区和已保存工作区之间没有区别，只是未命名工作区是为了方便您而自动创建的，并且在您保存之前会始终恢复。当您关闭打开了未命名工作区的窗口时，VS Code 会自动删除未命名工作区（在询问您确认后）。

工作区设置

工作区设置使您能够在您打开的工作区上下文中配置设置。工作区设置始终覆盖全局用户设置。它们实际存储在一个 JSON 文件中，其位置取决于您是打开了一个文件夹作为工作区，还是打开了一个 .code-workspace 文件。

有关设置范围及其文件位置的详细说明，请参阅 设置 文档。

单文件夹工作区设置

当您将文件夹作为工作区打开时，工作区设置存储在 .vscode/settings.json 中。

将文件夹作为工作区打开时的设置编辑器

多根工作区设置

当您将 .code-workspace 文件作为工作区打开时，所有工作区设置都会添加到 .code-workspace 文件中。

您仍然可以配置每个根文件夹的设置，设置编辑器会显示一个名为 文件夹设置 的第三个设置范围

打开多根工作区时的设置编辑器

每个文件夹配置的设置会覆盖 .code-workspace 中定义的设置。

工作区任务和启动配置

与 工作区设置 特定于某个工作区类似，任务和启动配置也可以限定在工作区范围内。

工作区任务和启动配置的位置取决于您是打开了一个文件夹作为工作区还是一个 .code-workspace 文件。如果打开文件夹，配置在 .vscode 文件夹中；如果打开 .code-workspace 文件，配置在 .code-workspace 文件中。此外，即使您打开了 .code-workspace 文件，任务和启动配置也始终可以在文件夹级别定义。

有关如何在 VS Code 中使用任务和启动配置的更详细概述，请参阅 任务 和 调试 章。

常见问题

多根工作区相比于文件夹有什么好处？

最明显的优势是，多根工作区允许您处理多个项目，这些项目可能并未存储在磁盘上的同一父文件夹中。您可以从任何位置选择文件夹添加到工作区。

即使您主要处理基于单文件夹的项目，使用 .code-workspace 文件也会带来好处。您可以在文件夹内存储多个 .code-workspace 文件，以便根据场景（例如 client.code-workspace、server.code-workspace 来从文件资源管理器中过滤掉不相关的文件夹）提供项目的某些方面的限定视图。由于 .code-workspace 文件支持 folders 部分的相对路径，因此这些工作区文件对所有人均适用，无论文件夹存储在哪里。

最后，如果对于某些项目，您想应用相同的工作区设置集或任务/启动配置，请考虑将这些添加到 .code-workspace 文件中，然后从该工作区添加或移除这些文件夹。

为什么 VS Code 在重启时会恢复所有未命名工作区？

未命名工作区的目的是需要您明确决定是否保留。首次创建未命名工作区时，VS Code 会将指定的文件夹添加到工作区文件中，同时添加所有现有的工作区设置。除非未命名工作区被保存或删除，否则此用户数据会始终恢复并显示在 VS Code 窗口中。

如何删除未命名工作区？

您可以通过关闭其窗口并取消保存未命名工作区的提示来删除未命名工作区。

我可以使用不含文件夹的多根工作区吗？

可以将 .code-workspace 文件的 folders 部分留空，这样您就可以得到一个不显示任何根文件夹的 VS Code 实例。在这种情况下，您仍然可以存储工作区设置，甚至是任务或启动配置。

VS Code 支持项目或解决方案吗？

VS Code 没有“项目”或“解决方案”的概念，这些概念有时在其他开发工具（如 Visual Studio IDE）中有定义。您可能会在 VS Code 文档中看到“项目”一词，但它通常指代“您正在处理的内容”。根据您的编程语言或框架，工具集本身可能会支持称为“项目”的东西来帮助定义构建配置或列举包含的文件。