教程：开始使用开发容器

在开始之前

有关完整的要求列表，包括远程 Dev Containers，请参阅先决条件。

由于 devcontainer.json 是构建开发容器所需的配置文件，因此项目中应包含该文件。该文件位于项目根目录中的 .devcontainer 文件夹；中间可能还有其他文件夹，例如 .devcontainer/.../.../devcontainer.json。

有两个选项可用于快速开始创建开发容器：创建简单文件，或使用 IDE 内功能基于模板创建配置文件。

开发容器的最低要求是用于构建它的镜像。

在项目视图中，右键点击项目名称并选择新建 | Dev Container 配置。
在打开的对话框中，PyCharm 会显示默认容器配置。默认模板足以创建开发容器，但如有必要，可以从 Dev Container 模板下拉列表中选择任何其他特定于语言的模板。
点击确定以创建一个相对简单（但包含大量注释）的 devcontainer.json：
// Default Ubuntu-based DevContainer Template. // For more customization options, see https://containers.dev/implementors/json_reference { name: "Default", image: "ubuntu:latest", customizations : { // Configure JetBrains IDE-specific properties jetbrains : { backend : "IntelliJ", settings : { // IDE settings can be added via “Show context actions”|“Add currently modified settings from IDE”. // A complete list of supported settings is also available through auto-completion }, plugins: [ // A set of plugin IDs. // Plugin ID can be found on the corresponding plugin’s page at https://plugins.jetbrains.com. ] } }, features: { "ghcr.io/devcontainers/features/git" : {}, // Add additional features to your project using auto-completion. }, // Comment out to connect as the root user. remoteUser: "ubuntu" }

构建 Dev Container 之前，请考虑将使用哪种 Dev Container 实现：

此外，使用 Remote Development 实现时，建议设置 IDE 以提供扩展的后端选择。

要使用自定义远程开发后端（例如，检查未发布的 IDE 构建版本中的问题），请执行以下操作：

打开 .devcontainer/devcontainer.json 。点击装订区域中的 Dev Containers 图标，然后选择创建 Dev Container 并挂载源代码…。如果系统提示选择后端 IDE，请选择 PyCharm。
构建开始后，服务视图应会自动打开以显示构建过程：
根据所选实现（远程开发与原生模式），以下流程会略有不同。
从列表中选择后端版本，并等待其和客户端下载：
在某些情况下，如果开发容器构建和后端部署过程超过 10 秒，客户端将不会打开；而是在 IDE 中显示带有连接按钮的通知。按下该按钮。
在以下窗口中按信任项目按钮，并等待客户端打开：
如何判断打开的是否已经是开发容器中的项目？通过左上角的后端状态详细信息微件。
由于没有后端部署步骤，开发容器项目会立即在 IDE 中打开。如果在中打开项目选项在设置 | 外观与行为 | 系统设置中设置为询问，项目将在确认后打开。
要判断项目是否在使用原生模式的开发容器中打开，请检查异常的项目根路径，以及编辑器左上角显示开发容器信息的微件。