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

CLion 2026.3 Help

C 和 C++ 的代码样式设置

CLion 中 C 和 C++ 的代码样式设置

在此页面上,可以配置 C 和 C++ 代码样式的各个切面。 代码样式偏好分组在下文描述的选项卡中。

通用

C/C++ 格式设置引擎

使用这些选项选择 CLion 在对 C 和 C++ 代码进行格式设置和重新格式化时使用的格式设置引擎。

  • %instance% 格式化程序 — 使用此选项通过内置格式化程序对代码进行格式设置,该格式化程序可在此页面的选项卡上配置。

    此选项还启用代码检查功能,可在编辑器中检测并突出显示违反格式化规则的情况。

    如果您在 Clang-Format 文件中配置了一些格式化样式,可以选择 从 .clang-format 文件读取代码样式 以应用其中的大多数样式。 请注意,如果存在任何冲突, .clang-format 文件中的设置会重写此页面上配置的设置。

  • Clang-Format — 使用此选项通过捆绑的 clang-format 或指定的外部 clang-format 对代码进行格式设置。 在这种情况下,CLion 格式设置选项不会生效,并且格式设置检查将被禁用。

将当前样式写入 .clang-format

点击此按钮可将 CLion 设置中的代码样式导出到 .clang-format 文件。

制表符和缩进

此选项卡可帮助指定 CLion 在键入代码或重新格式化现有代码时应如何对代码中的缩进进行格式设置。

制表符和缩进

缩进样式

选择 CLion 使用空格还是制表符缩进代码。

缩进大小

指定每个缩进级别要插入的空格数。

制表符宽度

指定一个制表符包含的空格数。

使用制表符缩进时如何对齐

选择当 缩进样式 设置为制表符时,CLion 如何对齐代码。 可用选项在表格下方说明。

即使生成的缩进过大也要对齐

选择此复选框后,即使构造位于过于靠右的位置,超过 在以下位置硬包装 限制的三分之二,也允许对齐。

使用空格(在任何制表符大小下看起来都对齐)

选择此选项时,CLion 使用制表符进行缩进,使用空格进行对齐。

这是推荐选项,因为使用第二个和第三个选项对齐的代码在具有不同制表符大小的编辑器中查看时可能会失去对齐。

仅使用制表符(不精确)

选择此选项时,CLion 使用制表符进行缩进和对齐,这可能无法实现精确对齐。

混合使用制表符和空格以实现最佳填充

选择此选项时,CLion 使用制表符进行缩进和对齐,并添加必要的空格以实现精确对齐。

命名

在此选项卡上,可以配置 C 和 C++ 的符号命名规则。 此选项卡还包含 启用 '命名不一致' 检查 复选框和 头临界样式 字段。

命名规则

如需了解有关配置命名规则并检查代码是否符合这些规则的更多信息,请参阅 命名规则。 如需了解头文件保护符模板,请参阅 头文件保护符。

语法样式

此选项卡中可配置的偏好有助于您强制执行代码语法样式。 当 CLion 使用代码补全和代码生成功能生成新代码、应用代码模板以及执行重构时,会考虑这些偏好设置。 通过使用具有相应设置的代码清理功能,它们也可以应用于现有代码。

对于每个偏好设置,底部的 调整前 和 调整后 窗格会显示所选值如何影响代码。

排序 include 指令

选择此选项以突出显示任何违反排序顺序的 #include 指令。

在 include 指令中使用的斜杠类型

使用此列表可选择 include 指令的首选路径分隔符:正斜杠或反斜杠。

如果可能,优先使用前向声明

如果选择此选项,自动导入会将添加前向声明的选项放在插入 include 指令的选项之前。

使用相对于源文件的路径

可以使用此选项配置 CLion 何时可以在生成的 include 指令中使用相对路径。

使用尖括号代替引号

默认情况下,生成的 include 指令会添加在引用中;如有必要,可以使用此选项指定在哪些情况下将生成的 include 指令添加在尖括号中。

默认指针初始化器

您可以指定 0、 nullptr 或 NULL 作为指针初始化器的首选初始化器,例如: const char *foo = nullptr。

在成员初始化器中使用统一初始化

默认情况下,CLion 在生成初始值设定项时使用 C++03 样式(例如,生成构造函数或应用将初始值设定项插入现有构造函数的快速修复时)。 您可以选中此复选框以在上述情况下启用 统一初始化。

在非静态数据成员初始化器中优先使用统一初始化

此选项可用于配置 CLion 在应用其功能时如何生成非 static 数据成员初始值设定项 (NSDMI)。 例如,当您对以下代码中的未初始化 field 应用快速修复 Alt+Enter 时

class test { int field; };

启用此选项时,CLion 会生成统一初始化 int field{0}; ;如果禁用此选项,则生成 int field = 0;。

按照初始化顺序排序成员初始化器

此选项允许您强制成员初始化器在构造函数初始化列表中的顺序。 类成员按照它们在包含类中声明的顺序进行初始化,因此为了减少混淆和错误,通常的做法是保持成员初始化器的顺序一致。

变量类型中的 'auto' 使用

此部分的偏好允许您分别配置 auto 在数值类型和非数值类型中的使用。 非数值类型的默认值是 当类型显而易见时 ,这意味着 auto 说明符仅在从初始化表达式中可以明显推导出类型的情况下引入。

cv 限定符的位置

此部分的偏好允许您配置 const 关键字应放置在其应用的类型之前还是之后,以及 const 和 volatile 限定符的优先顺序。

函数声明语法

使用此选项配置在函数声明中是使用尾随返回类型还是常规返回类型。

优先使用 typedef 或类型别名

使用此选项指定定义类型同义词的首选方式:以别名模板或类型别名的形式。 它还会影响 引入 Typedef 重构所使用的语法。

嵌套命名空间

使用此选项强制执行 C++17 嵌套命名空间的语法,这允许您以更简洁的方式声明多级命名空间。

重写函数

此部分的偏好允许您配置在重写函数和析构函数中需要哪些说明符。

大括号

此部分的偏好允许您定义在哪些情况下可以省略 if 语句和不同类型的循环语句下的单个嵌套语句的大括号。 除了直接的 不强制 和 始终强制 选项外,还可以选择仅对跨多行的语句要求大括号,或在嵌套语句本身为多行时要求大括号。 使用 移除冗余的大括号 配置 CLion 是否应移除不符合所选偏好设置的可选大括号。

大括号布局

使用此选项卡可调整 CLion 在生成新代码和重新格式化现有代码时排列大括号的方式。 例如,可以将命名空间、类型或函数定义的大括号放在行尾或下一行,并将命名空间定义放在同一行。

对于每个项目,底部的预览窗格会显示调整特定偏好后的变化。

大括号的代码样式

空行

此选项卡用于配置 CLion 是否应增加或减少命名空间、成员、区域和导入指令组周围的空行数量。 您可以调整值并在底部的预览窗格中查看您的偏好如何影响代码。

保留现有格式设置 部分中的选项仅在 CLion 重新格式化现有代码时应用,而 空白行 部分包含的选项在输入新代码时也会生效。

您在此选项卡上配置的选项适用于以下情况:

  • 当代码在编辑时或粘贴后自动进行格式设置时。

  • 当代码通过代码补全和代码生成功能生成时,当应用代码模板时,以及在重构期间。

  • 当您重新格式化现有代码时。

换行和换行规则

使用此选项卡配置源代码某些位置的换行。 此选项卡中的选项会在 CLion 重新格式化现有代码或输入新代码时应用。 您可以调整值并在底部的预览窗格中查看您的偏好如何影响代码。

换行的代码样式选项

空格

使用此选项卡配置如何在不同代码结构中插入或移除空格。 您可以调整值并在底部的预览窗格中查看您的偏好如何影响代码。

您在此选项卡上配置的选项适用于以下情况:

  • 当代码在编辑时或粘贴后自动进行格式设置时。

  • 当代码通过代码补全和代码生成功能生成时,当应用代码模板时,以及在重构期间。

  • 当您重新格式化现有代码时。

缩进和对齐

可以使用此选项卡上的偏好设置来指定 CLion 在特定情况下如何缩进和对齐代码。 在 缩进 组中,您可以定义制表符和缩进(您可以在 制表符和缩进 中配置)在特定情况下的应用方式。

在 对齐多个结构 组中,您可以定义跨多行的代码结构如何对齐(您可以在 换行和换行规则 中指定换行规则)。

您在此选项卡上配置的选项适用于以下情况:

  • 当代码在编辑时或粘贴后自动进行格式设置时。

  • 当代码通过代码补全和代码生成功能生成时,当应用代码模板时,以及在重构期间。

  • 当您重新格式化现有代码时。

新文件扩展名

使用此选项卡配置创建新的 C 和 C++ 文件时 CLion 使用的文件扩展程序。 左侧列表中的每个条目都会将源文件扩展程序与页眉文件扩展程序配对,并可为新文件名称设置命名约定。 诸如 .ixx 或 .cppm 这样的条目会定义不带页眉对的单个扩展程序。

使用列表上方的工具栏添加和移除条目。 在列表中选择一个条目以配置以下偏好设置:

源文件扩展名

选择新源文件的扩展程序,例如 cpp 或 c。

头文件扩展名

选择新页眉文件的扩展程序,例如 h 或 cuh。

文件命名约定

选择 CLion 应用于新文件名称的命名约定。 如需了解有关命名约定的更多信息,请参阅 命名规则。

2026年 11月 6日