CLion 2025.2 Help

代码样式。 C/C++

使用此页面配置 代码样式 选项以用于 C/C++ 文件。 当您更改这些设置时， 预览 面板将显示这将如何影响您的代码。

方案

在此区域，选择 代码样式方案并根据需要进行更改。 每当 CLion 生成、重构或重新格式化您的代码时，代码样式方案的设置都会自动应用。

这个IDE带有两个预定义的方案： Project 方案和 默认 方案。

  • 在 Project 方案中，您配置的设置仅适用于您当前的项目。

    这些设置存储在 代码样式 文件夹下的 .idea 中，并通过 VCS 与项目一起共享。

    在您为项目修改代码样式设置后，IDE 将创建文件夹。

  • 在 默认 方案（IDE级别的方案）中，您配置的设置将应用于所有已选择 默认 代码样式方案的现有项目。

    这些设置存储在 代码样式 文件夹中的 CLion 配置目录 ，并且不会通过 VCS 共享。

如果您想将项目代码样式方案用作您的默认方案，您可以将其复制到 IDE 级别。 另一种方式也是可行的：您可以使用 IDE 级别方案中的设置覆盖您当前的项目设置，并与您的团队其他成员共享。

项目

描述

方案

从此列表中，选择要使用的方案。 预定义的 方案以粗体显示。 自定义 方案，即预定义方案的副本，都是纯文本。 方案存储的位置会写在每个方案旁边，例如， 默认 方案是存储在 IDE 中， 项目 方案是存储在项目中。

显示方案操作

点击此按钮以调用用于管理方案的命令列表：

  • 复制到IDE… ：选择此选项将方案设置复制到 CLion 。

  • 导出 ：选择此选项以 IntelliJ IDEA 代码样式 XML 或 .clang-format 文件 格式导出所选方案（如果启用了 CLang 格式 插件）。

  • 导入方案 ：选择此选项以从指定位置导入选定类型的方案。

  • 复制项目: 选择此选项可用所选IDE代码样式方案的设置覆盖您当前的项目代码样式设置。

  • 复制… ：选择此选项以创建选定方案的副本。

  • 重置 ：选择此选项，将默认或捆绑的配色方案重置为与 CLion 一起提供的初始默认设置。 只有当一些更改已经完成时，此命令才会变为可用。

  • 重命名 ：选择此选项可更改所选自定义方案的名称。 按下 Enter 以保存更改，或 Escape 以取消。

设置从

点击此链接并选择要作为当前语言代码样式基础的语言。 列表包含以下选项：

项

描述

语言

选择此选项以继承来自其他语言的代码样式设置。 从打开的列表中选择源语言。 在这种情况下，仅适用于当前语言的设置会被采用。 所有其他设置均不受影响。

预定义样式

选择此选项以使用一种广为人知的代码样式指南。 从列表中选择以下标准之一。

注意： 每种代码样式仅影响基础设置的某些项目，其余部分保持不变。

以下样式仅适用于大括号的放置：

制表符和缩进

项目

描述

使用制表符

请使用 Tab 键进行缩进。 当复选框未勾选时， CLion 使用空格而非制表符。

智能制表符

  • 如果选中此复选框，嵌套代码块的缩进将根据需要使用制表符和空格，而对齐缩进将仅使用空格。

  • 如果此复选框未选中，将只使用选项卡。 这意味着一组符合指定制表符大小的空格将自动替换为一个制表符，这可能会导致精细对齐的破坏。

智能制表符 复选框在启用 使用制表符 选项时可用。

制表符大小

在此字段中，指定一个选项卡中包含的空格数。

连续缩进

指定延续前一行的行的缩进，使其清楚地成为同一语句或代码块的一部分。 当单个语句太长而无法放在一行时，会使用续行缩进。

空行时保持缩进

如果选中此复选框，CLion 将会保持空行的缩进，就像它们包含了一些代码一样。

如果取消勾选此复选框，CLion 将删除制表符和空格。

标签缩进

在此字段中，指定在下一行的选项卡语句之前插入的空格数量。

绝对标签缩进

如果选中此复选框，选项卡缩进将被视为绝对空格数。 否则，选项卡缩进将相对于先前的缩进级别进行计数。

在 lambda 表达式中缩进

在此字段中，输入 lambda 表达式的缩进。

缩进普通结构的成员

在此字段中，输入普通结构成员的缩进。

缩进类的成员

在此字段中，输入类成员的缩进。

缩进类/结构中的可见性关键字

在此字段中，输入可见性关键字（public、 protected 等）的缩进。

缩进命名空间的成员

在此字段中，输入命名空间成员的缩进。

预处理指令缩进

在此字段中输入预处理指令的缩进。

遵循代码缩进

选中此复选框以保持预处理指令的缩进与周围代码行相同。

空格

使用此选项卡来指定您希望在代码中的哪些位置添加空格。 为了让 CLion 在某个位置自动插入空格，请在列表中选择这个位置旁边的复选框。 结果将在预览窗格中显示。

包装和大括号

在此选项卡中，自定义代码样式选项，CLion 将在 重新格式化源代码 时应用。 左侧窗格包含例外列表（重新设置格式时保持 ），以及各种代码结构（列表、语句、操作、注解等）的放置和对齐选项。 右侧窗格显示预览。

对齐设置优先于缩进选项。

在以下位置硬包装

使用 强制换行位置 字段指定元素右侧所需的边距空间。 如果您选择了 默认 选项，那么将使用 全局设置中的右边距值。

输入时自动换行

使用 键入时换行 设置来指定如何将编辑的文本适应到指定的 强制换行位置 中：

  • 默认 ：在这种情况下 CLion 使用了在 全局设置中指定的 键入时换行 选项。

  • 是 ：在这个例子中，CLion 使用了在 右边距 字段里指定的值。

  • 否 ：在这种情况下，此选项被关闭，一行可以超过右侧边距指定的值。

视觉指南

使用 视觉参考线 字段来指定多个右边距。 您可以保留默认值，或者输入您的边距所需的空格数。 如果您想要指定多个边距，请输入由顿号分隔的数字。

在重新格式化时保持

在重新格式化源代码时，使用复选框来配置 CLion 将要做出的异常。 例如，默认情况下， 换行符 复选框被选中。 如果您的代码包含的行数比标准规范短，您可以在 换行符 多选框前取消选中，然后您再 重新格式化源代码以转换它们。

大括号放置选项

项目

描述

大括号放置风格

使用此列表指定 类声明、 函数声明和其他类型声明中大括号的放置位置。 可用选项包括：

  • 行尾 ：选择此选项将在声明行末放置开括号。

  • 下一行(如果换行) ：选择此选项，可以在多行声明行之后的行首放置开始大括号。

  • 下一行 ：选择此选项可以在声明行之后的行首放置开括号。

  • 下一行(移位) ：选择此选项将使声明行后的开放大括号换行，并移至相应的缩进级别。

  • 下一行，每次移位 ：选择此选项可以使开括号放在声明行的下一行，并且相应地移到相应的缩进级别，并且将下一行移到下一个缩进级别。

强制使用大括号

从这个列表中，为 if， for， while 和 do () while 语句选择大括号介绍方法。 可用选项包括：

  • 不强制 ：选择此选项以自动阻止引入括号。

  • 当多行时 ：如果语句占用多行，则选择此选项以自动引入括号。 请注意，CLion 分析的是整个声明中的行数，而非仅其条件。

    例如，如果代码是

    int foo (int Days) { if ((Days % 10) == 3) return 1; else return 0; }

    CLion 将自动插入大括号：

    int foo (int Days) { if ((Days % 10) == 3) { return 1; } else { return 0; } }

  • 始终 ：勾选此复选框以自动始终添加大括号。

空白行

使用此选项卡定义在重新格式化后，您希望 CLion 保留并在您的代码中插入多少空行以及在何处插入。 对于每种类型的位置，请指定要插入的空行数量。 结果将在预览窗格中显示。

项目

描述

保持最大的空白行

在此区域，指定在指定位置重新格式化后要保留的空行数。

最小的空白行

在此区域，指定在指定位置应存在的空行数量。

新文件扩展名

在此选项卡中，您可以定义 创建新的 C/C++ 源文件对话框中使用的源文件/头文件类型。 此选项卡还决定了它们在该对话框的 Type 字段中的出现顺序：选项卡中的第一个对是对话框类型列表中的第一个扩展名。

项

描述

源文件/头文件类型窗格。

源文件和头文件类型列表。 在此 设置 节点下指定的所有代码样式规则均适用于列出的文件类型。

源文件扩展名

从下拉列表中选择要与源文件关联的扩展名。

头文件扩展名

从下拉列表中选择要与头文件关联的扩展名。

文件命名约定

从下拉列表中选择首选的命名约定。 此设置定义了在 新建 C++ 类 对话框中创建新类时生成的文件名的大小写。

项目

快捷键

描述

Alt+Insert

点击此按钮将新的源文件/头文件类型对添加到列表中。 新对始终为 .cpp/.h 类型。 添加到列表后，从 源文件扩展名/头文件扩展名 下拉列表中分配所需的扩展名。

Alt+Delete

点击此按钮从列表中移除选定的源文件/头文件类型对。

""" Alt+Up 或 Alt+Down """

使用这些按钮在列表中上下移动选定的源文件/头文件类型对。

代码生成

项目

描述

通用

  • 行注释在第一列 ：如果选中此复选框，行注释将对齐到第一列；否则，它们将对齐到代码。

  • 块注释在第一列 ：如果选中此复选框，块注释将对齐到第一列；否则，它们将对齐到代码。

  • 块注释中新行缩进 ：如果选中此复选框，块代码的每一新行将缩进；否则，它将与块的第一行对齐。

  • Const/volatile 限定符位置。 此设置定义了代码生成期间关键字的顺序。

    选择 const int x = 0 单选按钮以将 const/volatile 限定符放在类型说明符之前。 选择 int const x = 0 单选按钮以将 const/volatile 限定符放在类型说明符和符号名称之间。

C++

  • 字段前缀 ：输入一个前缀，该前缀将添加到自动生成字段的名称之前。

  • 字段后缀 ：输入一个后缀，该后缀将添加到自动生成字段的名称之后。

  • Getter 前缀 ：输入一个前缀，该前缀将添加到自动生成 getter 的名称之前。 默认名称为 get。

  • Setter 前缀 ：输入一个前缀，该前缀将添加到自动生成 setter 的名称之前。 默认名称为 set。

  • 同时生成 != 和 == ：选中此复选框以在生成等式运算符时默认启用此设置，用于 选择字段对话框。

  • 同时生成 >、<=、>= 和 < ：选中此复选框以在生成关系运算符时默认启用此设置，用于 选择字段对话框。

  • 同时插入 "virtual" 属性和 "override" ：选中此复选框以允许在生成继承函数时同时插入 "virtual" 属性和 "override" 修饰符。 此选项适用于 C++11 标准或更高版本。

  • 使用 C++ 转换运算符 ：选中时，快速修复将在适当情况下插入 C++ 转换运算符，而不是 C 风格的转换。

文档注释

  • 添加 @brief 标签 ：选中此复选框以在 Doxygen 风格的注释中启用 @brief 标签。

  • 行注释中的标签前缀 ：点击 @param 或 \param 单选按钮以选择首选的前缀类型。

  • 块注释中的标签前缀 ：点击 @param 或 \param 单选按钮以选择首选的前缀类型。

命名约定

参见 命名规则。

最后修改日期： 2025年 9月 26日
代码样式代码样式。 SQL