WebStorm 2025.2 Help

自定义各类 Dev Container 设置

自定义 devcontainer.json 文件

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

添加修改后的设置

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

  2. 在左侧标尺中单击 创建 Dev Container ,选择 从 IDE 添加已修改的设置

    设置将作为 customizations 部分添加。 如果您希望同步两处设置或选择其他自定义选项,此功能将很有帮助。

    JSON 文件自定义部分

    您还可以添加非默认的应用程序级设置、修改已添加的设置选项、对其进行排序,或从 JSON 架构中添加属性。 请在 settings 文件的 Alt+Enter 部分按下 devcontainer.json 并选择相应选项。

    JSON 设置

您还可以从 JetBrains Marketplace 安装插件到 Dev Container 中。

添加插件

  1. 在浏览器中打开 JetBrains Marketplace

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

  3. 在插件页面中,向下滚动至 更多信息 部分并复制 plugin ID

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

  5. customizations 部分中添加以下代码:

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

    pluginID 是来自 JetBrains Marketplace 的所需插件 ID,例如 org.intellij.plugins.hcl

复制本地 Git 设置

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

如需检查 Dev Container 中的设置,请执行以下操作

  1. 服务工具窗口中,选择 Docker | Dev Containers 和所需的容器。

  2. 点击 启动 按钮启动容器。

  3. 点击 并选择 显示文件

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

    如果可用,将复制以下设置:

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

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

添加并引用本地 Feature

您可以定义自定义配置(本地 Feature),并在 devcontainer.json 文件中通过代码补全进行引用。

如需详细信息,请参阅 Development Containers 文档。

配置本地 Feature

  1. 在 IDE 的 项目 工具窗口中,右键单击 .devcontainer 文件夹并选择 新建 | 文件夹

  2. 在打开的窗口中,添加您的 Feature 名称,此名称应与 Feature ID 一致。

  3. 右键单击所创建的 Feature 文件夹并选择 新建 | 文件

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

    结果是两个文件都应位于所创建的 Feature 文件夹中。

    本地 Feature 文件夹
  4. 打开 devcontainer-feature.json 文件并添加您的 Feature 配置。 关于相关属性的信息,请参阅 Development Containers 文档。

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

    现在,您可以在 devcontainer.json 文件中引用自己的 Feature。

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

最后修改日期: 2025年 9月 26日