IntelliJ IDEA 2025.3 Help

工作区

IntelliJ IDEA 允许您同时处理多个项目,并在同一个框架(工作区)中查看和管理它们。 工作区表示一个开发环境,其中在同一位置包含所有所需的项目、代码和库。

您也可以在 IntelliJ IDEA 中创建多个工作区并在它们之间切换。

在工作区中工作可以提升团队协作、提高生产力,并有助于高效分配资源。

例如,在处理多个 Git 仓库、微服务或单仓库时,这种方式特别有用。

安装 Multi-Project Workspace 插件

此功能依赖于 Multi-Project Workspace插件,您需要安装并启用该插件。

  1. Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 Marketplace 选项卡,找到 Multi-Project Workspace插件,然后点击 安装 (如果有提示,请重启 IDE)。

创建工作空间

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

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

  1. 启动 新建项目向导。 如果 IntelliJ IDEA 当前未打开任何项目,请在欢迎屏幕上单击 新建项目。 否则,请在主菜单中选择 文件 | 新建 | 项目

  2. 命名新工作区,并在需要时更改其位置。

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

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

  4. 点击 创建 创建一个空工作区,或在 工作区项目 部分点击 "添加"图标 图标或 添加项目 链接从本地文件系统向工作区添加项目,然后点击 创建

    工作区项目

    IntelliJ IDEA 会使用附加的项目打开所创建的工作区。

在 IDE 中创建工作空间

  1. 从主菜单中选择 文件 | 打开

  2. 在本地文件系统中,选择要合并到一个工作区的项目,然后点击 打开

  3. 在打开的通知对话框中,点击

  4. 新建工作区 对话框中,添加工作空间的名称和位置,然后单击 OK

    新建工作区

    IntelliJ IDEA 会在 IDE 中打开包含所选项目的工作区。

工作空间结构

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

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

项目工具窗口

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

访问 jb-workspace.xml 文件

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

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

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

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

  1. 在 IDE 中打开您的工作区。

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

  3. 从本地文件系统中选择要添加的项目,并点击 打开

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

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

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

  1. Ctrl+Alt+S 打开设置,然后选择 系统设置

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

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

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

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

    通知

    结果是,该项目已添加到打开的工作区中。

在工作区内管理项目

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

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

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

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

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

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

检出部分项目

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

  1. 启动 新建项目向导。 如果 IntelliJ IDEA 当前未打开任何项目,请在欢迎屏幕上单击 新建项目。 否则,请在主菜单中选择 文件 | 新建 | 从版本控制创建项目

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

  3. 签出项目 对话框中,选择要在工作区中打开的项目并点击 OK

    签出项目

    IntelliJ IDEA 只加载所选项目,而保持其他项目未激活。 如果您决定添加未激活项目,请右键点击它,并从上下文菜单选择 检出 'project-name'

卸载项目

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

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

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

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

如果工作区中的项目使用 Gradle 或 Maven 构建工具,您可以将其从工作区中取消关联。

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

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

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

    如果您需要重新关联该项目,请在 项目 工具窗口中右键点击项目,并选择 加载 'project-name'

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

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

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

    如果您需要重新关联该项目,请在 项目 工具窗口中右键点击项目,并选择 加载 'project-name'

查看 Git 仓库

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

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

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

    Git 工具窗口

您可以在工作区中构建单个项目或所有项目。

构建项目

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

  2. 从主菜单中选择 构建 | 构建项目 'project-name'

    如果您想构建整个工作区,请选择 构建所有项目

最后修改日期: 2025年 12月 2日