# 在 IDE 中启动 Dev Container

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

> **TL;DR**
> 查看 [先决条件](prerequisites-for-dev-containers.html)和 [限制](dev-container-limitations.html)

您可以打开一个本地项目，该项目的根目录中包含  `.devcontainer`  文件夹和  `devcontainer.json`  文件，然后在 IntelliJ IDEA 中使用 Docker 从 IDE 启动一个 Dev Container。 IDE 允许您将源代码 [挂载](#create-dev-container-and-mount-sources) 或 [克隆](#create-dev-container-and-clone-sources) 到 Dev Container 中。

您还可以 [为远程项目启动一个 Dev Container](start-dev-container-for-a-remote-project.html)。

创建 Dev Container 并挂载源代码:

当您挂载源代码时，您的本地项目目录会被挂载（链接）到容器中，容器内的任何更改都会反映到您的本地文件中，反之亦然。 此过程比 [创建 Dev Container 并克隆源代码](#clone_sources) 操作更耗时，但对于希望在本地 IDE 中编辑文件并在容器中运行它们的开发工作流可能会有所帮助。

Procedure: 创建 Dev Container 并挂载源代码

1. 在 IDE 中用  `devcontainer.json`  文件打开您的项目。

2. 在编辑器中打开  `devcontainer.json`  文件。

3. 在左侧边栏中，点击 ![创建 Dev 容器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-docker-gateway.icons.devContainers.svg)，选择   创建 Dev Container 并挂载源代码…  并选择您希望在容器内使用的后端 IDE。

> **Note:**
> 如果您拥有 [all-product-pack](https://www.jetbrains.com.cn/all/) 许可证，您可以选择不同于当前本地的后端 IDE。 例如，如果您想在 Dev Container 内运行一个基于 Go 的项目，您可以选择   Goland   作为后端 IDE。

![挂载源](https://resources.jetbrains.com.cn/help/img/idea/2026.3/create_dev_container_mount.png)

4. 创建 Dev Container 的过程显示在 [服務](services-tool-window.html) 工具窗口中。

开发容器创建后，请点击   连接  。

![创建 Dev 容器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ide_dev_container.png)

容器已创建，项目已在 JetBrains Client 中打开。

![在开发容器中的项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/container_with_project.png)

创建 Dev Container 并克隆源代码:

当您克隆源代码时，代码会从远程存储库（如 GitHub）克隆到容器中。 虽然此过程比   创建开发容器并挂载源代码   操作更快，但请注意，整个 Git 存储库都会被检出。

然而，此操作对于希望获得一个隔离的、可复现的环境而不影响本地文件的情况非常有用。

Procedure: 创建 Dev Container 并克隆源代码

1. 在 IDE 中用  `devcontainer.json`  文件打开您的项目。

2. 在编辑器中打开  `devcontainer.json`  文件。

3. 在左侧边栏中，点击 ![创建 Dev 容器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-docker-gateway.icons.devContainers.svg)，选择   创建 Dev Container 并克隆源代码  。

![克隆源代码](https://resources.jetbrains.com.cn/help/img/idea/2026.3/create_dev_container_clone.png)

4. 在   新建 Dev Container   页面上，指定 IDE、您的 Git 仓库、分支，然后点击   构建容器并继续  。

![新建 Dev Container](https://resources.jetbrains.com.cn/help/img/idea/2026.3/new_dev_container_clone.png)

5. 创建 Dev Container 的过程显示在 [服務](services-tool-window.html) 工具窗口中。

开发容器创建后，请点击   连接  。

![创建 Dev 容器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ide_dev_container.png)

![克隆 - 开发容器已创建](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_ide_dev_container_clone_open_project.png)

容器已创建，项目已在 JetBrains Client 中打开。

![在开发容器中的项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/container_with_project.png)

## 其他上下文菜单选项

除了 [克隆源代码](#clone_sources) 或 [挂载源代码](#create-dev-container-and-mount-sources) 外，上下文菜单中还提供以下其他选项：

|  条目  |  描述  |
| --- | --- |
|    显示开发容器    |     使用此选项检查现有 Dev Container 的列表。       您可以查看哪些处于活动状态并正在运行，停止它们或重新启动它们。      ![查看 Dev Containers](https://resources.jetbrains.com.cn/help/img/idea/2026.3/see_containers.png)  |
|    管理开发容器后端    |     使用此选项从 Docker 共享卷中移除不必要的容器。      ![管理后端](https://resources.jetbrains.com.cn/help/img/idea/2026.3/dev_container_manage_backends.png)  |
|    从 IDE 添加已修改的设置    |     使用此选项将您的 IDE 设置添加到运行在 Dev Container 内的 IDE 后端。 有关更多信息，请参阅 [从 IDE 添加修改后的设置](customizing-devcontainer-json-file.html#add_settings)。     |

