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

CLion 2026.3 Help

EditorConfig 配置

安装 EditorConfig 插件

此功能依赖于 EditorConfig 插件,需要安装并启用。

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 插件。

  2. 找到 EditorConfig 插件,然后点击 安装。 如果出现提示,请重启 IDE。

CLion 允许您通过 EditorConfig 支持来管理每个文件集的所有代码样式设置。

只需将一个 .editorconfig 文件放入包含要定义其代码样式的文件的根目录,并在 设置 | 编辑器 | 代码风格 中启用 EditorConfig 支持:

在设置中启用 EditorConfig 支持

如果项目中有多种代码样式(例如用于测试和用于生产代码),则可以在项目中的相应文件夹中使用多个 .editorconfig 文件。 这样可以同时遵循多种代码样式标准。

.editorconfig 文件中的所有选项都会应用于它所在的目录以及所有子目录,并覆盖当前项目的代码样式。 如果父目录中的 .editorconfig 或其他 .editorconfig 文件中没有定义任何内容,则会从当前 代码风格方案 中获取。 有关未定义 (unset) 属性的更多信息,请参阅 EditorConfig 文档。

.editorconfig 文件中的所有选项分为以下几类:

  • 标准选项 例如 indent_size、 indent_style 等等。 这些选项没有任何特定领域的前缀。

  • 适用于所有语言且带有 ij_ 前缀的通用 IntelliJ 选项:

    • ij_visual_guides

    • ij_formatter_off_tag

    • ij_formatter_on_tag

    • ij_formatter_tags_enabled

    • ij_wrap_on_typing

    • ij_continuation_indent_size

    • ij_smart_tabs

  • 许多(但不是全部)语言都支持通用 IntelliJ 选项。 它们以 ij_any 前缀开头,例如 ij_any_brace_style。

  • IntelliJ 特定语言的选项从 ij_<lang>_ 前缀开始,其中 <lang> 是语言域 ID(通常是小写语言名称),例如, ij_java_blank_lines_after_imports。

所有 IntelliJ .editorconfig 属性在 代码风格方案 中有对应的选项,并且具有类似的名称。

添加一个.editorconfig文件

  1. 在 项目 工具窗口 (Alt+1) 中,右键点击包含要定义其代码样式的文件的 sourcethe 目录,并从上下文菜单中选择 新建 | EditorConfig。

  2. 选择您想要定义的属性,以便 CLion 为它们创建存根,或者将所有复选框留空以手动添加所需的属性。

  3. 要预览代码样式设置的更改将如何影响实际源文件,请点击 眼睛图标 文件的页边空白处的 .editorconfig 并选择您想要预览更改的源文件。 预览将在右侧打开。

    请确保您选择的文件与您点击 眼睛图标 旁边的掩码相对应。

    您可以在预览窗格中进行更改,以试验和测试您的配置更改如何反映,而无需担心对源代码进行不必要的更改:当您关闭 .editorconfig 文件时,所有这些更改都会被丢弃。

  4. 重新格式化您的代码。 可以重新格式化 代码段、 文件 或目录中的所有文件。

    或者,可以将 IDE 配置为 在保存时重新格式化代码。

要快速了解当前在编辑器中打开的文件是否有任何代码样式选项被 .editorconfig 文件中的属性重写,请使用状态栏中的缩进微件。

微件中的 图标表示存在一个 .editorconfig 文件会重写当前代码样式方案中的某些设置。

具有 EditorConfig 图标的缩进小部件

点击小部件:

  • 点击 打开 .editorconfig 以打开最近影响到您当前工作文件的 .editorconfig 文件。

  • 选择 显示与项目相关的文件… 以打开项目中所有 .editorconfig 文件的列表。

  • 点击 禁用 EditorConfig 以在您的项目中禁用 EditorConfig 支持并使用当前代码样式方案中的设置。 您还可以在设置中禁用 EditorConfig 支持。

从缩进微件打开的 EditorConfig 菜单

将代码样式导出到 .editorconfig 文件

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 编辑器|代码样式。

  2. 选择要导出的代码样式 方案: 项目方案或 IDE 级别方案之一。

  3. 点击 "显示方案操作"按钮 ,选择 导出 ,然后 EditorConfig 文件。

    将代码样式设置导出为 .editorconfig 文件
  4. 指定您要保存文件的文件夹。

要导入 .editorconfig 文件中的代码样式设置,请将该文件拖到 项目 工具窗口 (Alt+1) 或 视图 | 工具 Windows | 项目) 中所需的文件夹。

禁用 EditorConfig 支持

如果您决定在创建 .editorconfig 设置文件后使用 IDE 设置,您可以禁用 EditorConfig 支持,而无需从项目中删除已创建的 .editorconfig 文件。

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 编辑器|代码样式。

  2. 清除 启用 EditorConfig 支持 复选框。

  3. 应用更改并关闭对话框。

2026年 11月 6日