CLion 2025.2 Help

CLion Nova C++ 代码样式设置

CLion Nova 代码样式设置

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

通用

C++ 格式化引擎

使用这些单选按钮选择在 CLion Nova 格式化和重新格式化您的 C++ 代码时应使用的格式化引擎。

  • ReSharper 格式化器 — 如果您更喜欢默认的 ReSharper C++ 格式化偏好集,或者之前已配置并保存了基于层的格式化样式( *.DotSettings ),请使用此选项。

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

    如果您在 Clang-Format 文件中配置了一些格式化样式,可以选择 从 .clang-format 文件读取代码样式 以应用其中的大多数样式。 请注意,如果存在冲突, .clang-format 文件中的设置将覆盖 *.DotSettings 中的设置。

  • Clang-format — 如果您更喜欢默认的 LLVM 风格格式化,并希望使用指定版本的 clang-format 代码格式化器格式化和重新格式化代码,请使用此选项。

将当前样式写入 .clang-format

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

制表符和缩进

此选项卡帮助您指定 CLion Nova 在您输入代码或重新格式化现有代码时应如何格式化缩进。

制表符和缩进
使用空格(推荐,在任何制表符大小下看起来都对齐)

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

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

仅使用制表符(不精确)

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

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

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

命名

在此选项卡,您可以配置 C++ 的符号命名规则。

命名规则

语法样式

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

带有 通知方式 选择器的首选项有相应的代码检查功能,如果检查范围内的语法样式与首选样式不同,系统会通知您。 使用选择器,您可以配置检查的严重性级别。

排序 include 指令

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

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

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

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

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

使用相对于源文件的路径

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

使用尖括号代替引号

默认情况下,生成的 include 指令会以引号添加,如有必要,您可以使用此选择器指定在某些情况下生成的 include 指令以尖括号添加。

默认指针初始化器

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

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

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

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

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

class test { int field; };

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

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

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

变量类型中的 'auto' 使用

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

cv 限定符的位置

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

函数声明语法

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

优先使用 typedef 或类型别名

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

嵌套命名空间

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

重写函数

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

大括号

此部分的偏好允许您定义在哪些情况下可以省略 if 语句和不同类型的循环语句下的单个嵌套语句的大括号。 除了直接的 不强制 >和 始终强制 选项外,您还可以选择仅在语句跨多行或嵌套语句本身是多行时要求大括号。

移除冗余

使用此选项配置 CLion Nova 是否应移除不符合所选偏好的可选大括号。

大括号布局

使用此选项卡调整 CLion Nova 在生成新代码和重新格式化现有代码时如何排列大括号;特别是,有几种方法可以在 iffor 运算符之后放置大括号。

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

大括号的代码样式

空行

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

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

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

  • 当代码在编辑或粘贴后自动格式化时(您可以在 编辑器 | 常规 | 输入辅助 中切换自动格式化)。

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

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

换行和换行规则

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

换行的代码样式选项

空格

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

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

  • 当代码在编辑或粘贴后自动格式化时(您可以在 编辑器 | 常规 | 输入辅助 中切换自动格式化)。

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

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

缩进和对齐

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

对齐多个结构 组中,您可以定义跨多行的代码结构如何对齐(您可以在 代码编辑 | C++ | 格式化样式 | 换行和换行规则 中指定换行规则)。

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

  • 当代码在编辑或粘贴后自动格式化时(您可以在 编辑器 | 常规 | 输入辅助 中切换自动格式化)。

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

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

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