# 自定义各种 Dev Container 设置

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

## 自定义 devcontainer.json 文件

您可以通过添加所需的设置、插件等来自定义  `devcontainer.json`  文件。

Procedure: 添加修改后的设置

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

2. 在左侧边栏中，点击 ![创建 Dev 容器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-docker-gateway.icons.devContainers.svg)，选择   从 IDE 添加已修改的设置  。

这些设置会作为  `customizations`  部分添加。 如果您希望同步两个设置或选择其他自定义选项，这可能会很有用。

![JSON 文件自定义部分](https://resources.jetbrains.com.cn/help/img/idea/2026.3/customization_section.png)

还可以添加非默认的应用程序级别设置、修改已添加的设置选项、对其进行排序，或从 JSON 架构添加属性。 在  `设置`  部分的  `devcontainer.json`  文件中按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) 并选择适当的选项。

![JSON 设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/json_settings.png)

您还可以从 [JetBrains marketplace](https://plugins.jetbrains.com/) 安装插件到开发容器中。

Procedure: 添加插件

1. 在浏览器中打开 [JetBrains marketplace](https://plugins.jetbrains.com/)。

2. 找到所需的插件并打开插件页面。

3. 在插件页面上，向下滚动到   附加信息   部分并复制   插件 ID  。

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

5. 在  `customizations`  部分中，添加以下代码：

```JSON
{
    "customizations": {
        "jetbrains": {
            "plugins": [
                "org.intellij.plugins.hcl"
            ]
        }
    }
}


```

`pluginID`  是来自 [JetBrains marketplace](https://plugins.jetbrains.com/) 的所需插件的 ID，例如  `org.intellij.plugins.hcl` 。

## 复制本地 Git 设置

您无需在 Dev Container 内额外配置 Git 设置。 Git 设置会从您的本地全局  `.gitconfig`  文件自动添加到 Dev Container 中。

要检查 Dev Container 内的设置，请执行以下操作

Procedure:

1. 在 [服务工具窗口](services-tool-window.html)中，选择   Docker | Dev Containers   和所需的容器。

2. 通过点击   开始   按钮启动容器。

3. 点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg) 并选择   显示文件  。

4. 在文件列表中选择   .gitconfig  。

如果可用，将复制以下设置：

```
user.email,
user.name,
pull.rebase,
alias.*

```

`alias.*`  选项表示所有的别名设置。

> **Note:**
> Git 需要在构建容器的用户机器和目标 Dev Container 中都可用。

Procedure: 添加特定的 IDE 后端

您可以在您的  `container.json`  中指定 IDE 的名称，这样每次您 [为远程项目启动 Dev Container](start-dev-container-for-a-remote-project.html) 时，都会自动启动相应的 IDE 后端。

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

2. 在  `customizations`  部分中，添加以下代码：

```JSON
{
    "customizations": {
        "jetbrains": {
            "backend": "<IDE-name>"
        }
    }
}

```

`<IDE 名称>`  是您要使用的 IDE 的名称。 例如，  `IntelliJ` 。

## 添加并引用本地 Feature

可以定义一个自定义配置（本地 Feature），并在  `devcontainer.json`  文件中使用代码补全引用它。

如需更多详细信息，请参阅 [开发容器](https://containers.dev/implementors/features-distribution/#addendum-locally-referenced) 文档。

Procedure: 配置本地 Feature

1. 在 IDE 中，在   项目   工具窗口中，右键点击  `.devcontainer`  文件夹，然后选择  `新建 | 文件夹` 。

2. 在打开的窗口中，添加 Feature 的名称，该名称应等于 Feature ID。

3. 右键点击已创建的 Feature 文件夹，然后选择  `新建 | 文件` 。

首先，创建  `devcontainer-feature.json`  文件，然后创建  `install.sh`  文件。

因此，这两个文件都应位于已创建的 Feature 文件夹中。

![本地 Feature 文件夹](https://resources.jetbrains.com.cn/help/img/idea/2026.3/local_feature_files.png)

4. 打开  `devcontainer-feature.json`  文件并添加 Feature 配置。 有关相关属性的信息，请参阅 [开发容器](https://containers.dev/implementors/features/#devcontainer-feature-json-properties) 文档。

5. 打开  `install.sh`  文件并添加用于安装或配置 Feature 的脚本。

现在可以在  `devcontainer.json` 文件中引用 Feature。

6. 打开  `devcontainer.json`  文件，并在  `features`  部分中，使用自动补全添加对本地 Feature 的引用。

