# 工作区

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

IntelliJ IDEA 允许您同时处理多个项目，并在单个框架（工作区）内以视图方式查看和管理它们。 工作区表示将所有必需的项目、编码和库集中在一处的开发环境。

还可以创建多个工作区，并在 IntelliJ IDEA 中切换它们。

在工作区中工作可以改善团队协作、提高工作效率，并帮助高效分配资源。

例如，在处理多个 Git 仓库、微服务或单仓库时，这尤其有用。

Procedure: 安装 Multi-Project Workspace 插件

此功能性依赖于 [Multi-Project Workspace](https://plugins.jetbrains.com/plugin/24765-multi-project-workspace) 插件，您需要安装并启用该插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  多项目工作区  插件，然后点击   安装  。 如果出现提示，请重启 IDE。

## 创建工作空间

您可以在 IntelliJ IDEA 欢迎界面或 IDE 中创建一个空的工作空间，或创建包含项目的工作空间。

Procedure: 从欢迎界面创建新工作空间

1. 启动 IntelliJ IDEA。

在 IntelliJ IDEA 主屏幕上，点击  `新建 | 项目` 。 如果已经打开了项目，请从主菜单中选择  `文件 | 新建项目` 。

2. 指定新工作区的名称，并在必要时更改其位置。

3. 选择   创建 Git 仓库   将新工作区置于版本控制之下。 由于工作区是一个仅包含项目引用的文件，此操作仅为工作区创建 Git 仓库。

您也可以随时在之后进行此操作。

> **Note:**
> `.gitignore`  文件无论如何都会生成。

4. 点击   创建   创建空工作区，或在   工作区项目   部分下，点击 !["添加"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 或   添加项目   链接，以将本地文件系统中的项目添加到工作区，然后点击   创建  。

![工作区项目](https://resources.jetbrains.com/help/img/idea/2026.3/workspace_projects.png)

IntelliJ IDEA 将打开已创建的工作区及其附加的项目。

## 工作空间结构

在 IDE 中打开已创建的工作空间后，您可以在   项目   工具窗口中查看其结构。 此工具窗口列出了所有包含的项目。 请注意，工作空间不会更改原始项目的配置或其位置。

IntelliJ IDEA 会检测项目中使用的构建工具，用相应的图标进行标记，并显示其他工具窗口（例如 Maven 和 Gradle）。

![项目工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/workspace_structure.png)

项目   工具窗口还包含生成的工作空间文件，包括  `jb-workspace.xml`  文件。 此文件存储工作空间项目的路径；即使您从本地文件系统中移除某个项目，也会保留该项目路径。 不过，您可以手动编辑  `jb-workspace.xml`  文件来添加或移除项目。

Procedure: 访问 jb-workspace.xml 文件

1. 在   项目   工具窗口中，选择   工作区文件 | .idea  。 定位该文件并在编辑器中将其打开。

2. 在打开的列表中，选择  `jb-workspace.xml`  文件以在编辑器中打开。

您可以将新创建、已存在或克隆的项目添加到已打开的工作空间。

Procedure: 从工作空间的上下文菜单添加项目

1. 在 IDE 中打开工作区。

2. 在   项目   工具窗口中，右键点击工作区并选择   将项目添加到工作区  。

3. 从本地文件系统中选择要添加的项目，然后点击   打开  。

项目已添加到工作区。 如需移除它，请右键点击该项目并选择   从工作区中移除 project-name  。

IntelliJ IDEA 支持工作区内项目中的 Maven 和 Gradle 构建工具。 这些项目会在项目树中使用相应的 Maven 或 Gradle 图标进行标记，并提供相关工具窗口。

Procedure: 通过主菜单向已打开的工作空间添加项目

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `系统设置` 。

2. 在右侧的选项中，在   项目   部分下，选择   询问   选项并点击   OK  。

3. 在主菜单中，选择  `文件 | 打开`  以从本地文件系统添加项目，或选择  `文件 | 新建 | 从版本控制创建项目`  以从外部存储库添加项目。

4. 按照提示的步骤操作。

5. 在打开的通知对话框中，点击   添加到工作区  。

![通知](https://resources.jetbrains.com/help/img/idea/2026.3/workspace_notification.png)

因此，项目会添加到打开的工作区。

## 管理工作区内的项目

您可以在工作空间中管理项目，其中包括以下重要操作：

* 仅检出工作空间中定义的部分项目。

* 如果暂时不需要处理某些项目，可将其从工作空间中卸载（对于 Gradle 或 Maven，则为取消链接项目）。

* 在处理不同的 Git 项目时，查看并管理这些项目所属的 Git 存储库。

* 将工作空间配置文件提交到 Git 存储库，以实现共享和版本控制。

* 由于创建的工作空间位于其自身的存储库中，如果您希望他人访问其定义的项目，您可以共享工作空间的链接。

Procedure: 签出项目子集

如果您只想处理所克隆存储库中的特定项目，您可以仅检出所需的项目。

1. 从主菜单中选择  `文件 | 新建 | 从版本控制获取` 。

2. 在   克隆存储库   对话框中，添加仓库信息并点击   克隆  。

3. 在   签出项目   对话框中，选择要在工作区中打开的项目，然后点击   OK  。

![签出项目](https://resources.jetbrains.com/help/img/idea/2026.3/checkout_projects.png)

IntelliJ IDEA 仅加载所选项目，并使其他项目保持非活动状态。 如果决定添加非活动项目，请右键点击它，然后从上下文菜单中选择   签出 'project-name'  。

Procedure: 卸载项目

可以在工作区中加载或卸载项目。 例如，创建或打开包含多个项目的工作区后，如果决定只处理其中一些项目，可以卸载不需要的项目。

1. 在   项目   工具窗口中，右键点击要卸载的项目。

2. 在上下文菜单中，选择   卸载 'project-name'  。

该项目将变为非活动状态。 使用   加载 'project-name'   选项可恢复项目的活动状态。

如果工作区内的项目使用 Gradle 或 Maven 构建工具，可以取消该项目与工作区的关联。

Gradle:

Procedure: 取消关联 Gradle 项目

1. 点击右侧边栏上的 ![Gradle 图标](https://resources.jetbrains.com/help/img/idea/2026.3/gradle.icons.expui.gradle.svg) 以打开   Gradle   工具窗口。

2. 右键点击所需项目，然后从上下文菜单中选择   解除 Gradle 项目链接  。

IntelliJ IDEA 会从   Gradle   工具窗口中移除该项目，停止其同步，并在工作区中将其停用。

如需再次关联该项目，请在   项目   工具窗口中右键点击它并选择   加载 'project-name'  。

Maven:

Procedure: 取消关联 Maven 项目

1. 点击右侧边栏上的   Maven   图标以打开   Maven   工具窗口。

2. 右键点击所需项目，然后从上下文菜单中选择   取消链接 Maven 项目  。

IntelliJ IDEA 会从   Maven   工具窗口中移除该项目，停止其同步，并在工作区中将其停用。

如需再次关联该项目，请在   项目   工具窗口中右键点击它并选择   加载 'project-name'  。

Procedure: Git 仓库视图

1. 在 IDE 中，点击菜单栏中的 Git 仓库。 上下文菜单会列出所有仓库。

![Git 分支](https://resources.jetbrains.com/help/img/idea/2026.3/workspace_branches.png)

2. 打开   Git   窗口时，您会注意到所有项目都按各自的存储库进行分组，以便于管理并提高可读性。

双击该存储库，仅查看所选项目及其分支的提交。

![Git 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/git_toolwindow_workspaces.png)

可以构建工作区内的单个项目或所有项目。

Procedure: 构建项目

1. 在   项目   工具窗口中，选择要构建的项目。

2. 从主菜单中选择  `Build | Build Project 'project-name'` 。

如果要构建整个工作区，请选择   构建所有项目  。