llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

自定义各种 Dev Container 设置

自定义 devcontainer.json 文件

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

添加修改后的设置

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

  2. 在左侧边栏中,点击 创建 Dev Container ,选择 从 IDE 添加修改的设置。

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

    JSON 文件定制部分

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

    JSON 设置

您还可以从 JetBrains marketplace 安装插件到开发容器中。

添加插件

  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.* 选项表示所有的别名设置。

添加特定的 IDE 后端

您可以在您的 container.json 中指定 IDE 的名称,这样每次您 为远程项目启动 Dev Container 时,都会自动启动相应的 IDE 后端。

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

  2. 在 customizations 部分中,添加以下代码:

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

    <IDE-name> 是您要使用的 IDE 的名称。 例如, IntelliJ。

添加并引用本地 Feature

您可以定义自定义配置(本地 Feature),并使用代码补全从 devcontainer.json 文件中引用它。

有关更详细的信息,请参阅 Development Containers 文档。

配置本地 Feature

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

  2. 在打开的窗口中,添加与 Feature ID 相等的 Feature 名称。

  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 的引用。

2026年 11月 6日