# 代码样式。 C/C++

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

> **TL;DR**
> `文件 | 设置 | 编辑器 | 代码样式 | C/C++`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 编辑器 | 代码样式 | C/C++`  适用于 macOS
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)

> **Warning:**
> 此页面上的部分信息已过时，很快将进行更新。

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

## 方案

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

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

* 在 项目 方案中，您配置的设置仅适用于您当前的项目。 这些设置存储在 `代码样式` 文件夹下的 `.idea` 中，并通过 VCS 与项目一起共享。 在您为项目修改代码样式设置后，IDE 将创建文件夹。

* 在 默认 方案（IDE级别的方案）中，您配置的设置将应用于所有已选择 默认 代码样式方案的现有项目。 这些设置存储在 `代码样式` 文件夹中的 CLion [配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)，并且不会通过 VCS 共享。

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

|  项  |  描述  |
| --- | --- |
|  方案  |     从此列表中，选择要使用的方案。  预定义的  方案以粗体显示。  自定义  方案，即预定义方案的副本，都是纯文本。 方案存储的位置会写在每个方案旁边，例如，   默认   方案是存储在 IDE 中，   项目   方案是存储在项目中。     |
|  ![显示方案操作](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)  |     点击此按钮以调用用于管理方案的命令列表：        * 复制到 IDE… ：选择此选项将方案设置复制到 CLion 。 > **Tip:** > 这个选项仅适用于 项目 方案。    * 导出 ：选择此选项以 IntelliJ IDEA 代码样式 XML 或 .clang-format 文件 格式导出所选方案（如果启用了 [CLang Format](clangformat-as-alternative-formatter.html) 插件）。 > **Tip:** > 此选项可用于 项目 和 IDE 方案。    * 导入方案 ：选择此选项以从指定位置导入选定类型的方案。 > **Tip:** > 此选项可用于 项目 和 IDE 方案。    * 复制到项目… : 选择此选项可用所选IDE代码样式方案的设置覆盖您当前的项目代码样式设置。 > **Tip:** > 这个选项仅对 IDE 方案可用。    * 复制… ：选择此选项以创建选定方案的副本。 > **Tip:** > 这个选项仅对 IDE 方案可用。    * 重置 ：选择此选项，将默认或捆绑的配色方案重置为与 CLion 一起提供的初始默认设置。 只有当一些更改已经完成时，此命令才会变为可用。 > **Tip:** > 这个选项仅对 IDE 方案可用。    * 重命名 ：选择此选项可更改所选自定义方案的名称。 按下 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) 以保存更改，或 `Escape` (Windows), `⎋` (macOS), `⎋` (IntelliJ IDEA Classic (macOS)), `⎋` (macOS System Shortcuts), `Escape` (XWin), `Escape` (GNOME), `Escape` (KDE), `Escape, Escape` (Emacs), `Escape` (Sublime Text), `⎋` (Sublime Text (macOS)), `⎋` (Xcode), `Escape` (Visual Studio), `⎋` (Visual Studio (macOS)), `Escape` (ReSharper), `⎋` (ReSharper (macOS)), `Escape` (QtCreator), `⎋` (QtCreator (macOS)), `Escape` (NetBeans), `Escape` (Eclipse), `⎋` (Eclipse (macOS)) 以取消。 > **Tip:** > 这个选项仅对 IDE 方案可用。    |

## 设置从

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

|  项  |  描述  |
| --- | --- |
|  语言  |  选择此选项以继承来自其他语言的代码样式设置。 从打开的列表中选择源语言。 在这种情况下，仅适用于当前语言的设置会被采用。 所有其他设置均不受影响。  |
|  [预定义样式](predefined-code-styles.html)  |     选择此选项以使用一种广为人知的代码样式指南。 从列表中选择以下标准之一。        注意：  每种代码样式仅影响基础设置的某些项目，其余部分保持不变。        * [Google](https://google.github.io/styleguide/cppguide.html)    * [LLVM](http://llvm.org/docs/CodingStandards.html)    * [LLDB](http://lldb.llvm.org/lldb-coding-conventions.html)    * [Qt](https://wiki.qt.io/Qt_Coding_Style)    * [GNU](https://en.wikipedia.org/wiki/GNU_coding_standards)    * [Stroustrup](https://www.stroustrup.com/bs_faq2.html#layout-style)      以下样式仅适用于大括号的放置：        * [Allman 大括号](https://en.wikipedia.org/wiki/Indent_style#Allman_style)    * [Whitesmiths 大括号](https://en.wikipedia.org/wiki/Indent_style#Whitesmiths_style)    * [K&amp;R 大括号](https://en.wikipedia.org/wiki/Indent_style#K.26R_style)    |

## 制表符和缩进

|  项  |  描述  |
| --- | --- |
|    使用制表符    |     请使用 `Tab` (Windows), `⇥` (macOS), `⇥` (IntelliJ IDEA Classic (macOS)), `⇥` (macOS System Shortcuts), `Tab` (XWin), `Tab` (GNOME), `Tab` (KDE), `Tab` (Emacs), `Tab` (Sublime Text), `⇥` (Sublime Text (macOS)), `⇥` (Xcode), `Tab` (Visual Studio), `⇥` (Visual Studio (macOS)), `Tab` (ReSharper), `⇥` (ReSharper (macOS)), `Tab` (QtCreator), `⇥` (QtCreator (macOS)), `Tab` (NetBeans), `Tab` (Eclipse), `⇥` (Eclipse (macOS))键进行缩进。 当复选框未勾选时， CLion 使用空格而非制表符。     |
|    智能制表符    |      * 如果选中此复选框，则嵌套代码块的缩进将根据需要使用制表符和空格，而对齐缩进则仅使用空格。    * 如果此复选框未选中，将只使用选项卡。 这意味着一组符合指定制表符大小的空格将自动替换为一个制表符，这可能会导致精细对齐的破坏。        智能制表符   复选框在启用   使用制表符   选项时可用。     |
|    选项卡大小    |  在此字段中，指定一个选项卡中包含的空格数。  |
|    续行缩进    |     指定延续前一行的行的缩进，使其清楚地成为同一语句或代码块的一部分。 当单个语句太长而无法放在一行时，会使用续行缩进。     |
|    保持空行的缩进    |     如果选中此复选框，CLion 将会保持空行的缩进，就像它们包含了一些代码一样。       如果取消勾选此复选框，CLion 将删除制表符和空格。     |
|    标签缩进    |  在此字段中，指定在下一行的选项卡语句之前插入的空格数量。  |
|    绝对标签缩进    |  如果选中此复选框，选项卡缩进将被视为绝对空格数。 否则，选项卡缩进将相对于先前的缩进级别进行计数。  |
|    在 lambda 表达式中缩进    |  在此字段中，输入 lambda 表达式的缩进。  |
|    缩进普通结构的成员    |  在此字段中，输入普通结构成员的缩进。  |
|    缩进类的成员    |  在此字段中，输入类成员的缩进。  |
|    缩进类/结构中的可见性关键字    |     在此字段中，输入可见性关键字（  public 、  protected  等）的缩进。     |
|    缩进命名空间的成员    |  在此字段中，输入命名空间成员的缩进。  |
|    预处理指令缩进    |  在此字段中输入预处理指令的缩进。  |
|    遵循代码缩进    |  选中此复选框以保持预处理指令的缩进与周围代码行相同。  |

## 空格

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

## 包装和大括号

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

> **Tip:**
> 对齐设置优先于缩进选项。

### 在以下位置硬包装

使用   在以下位置硬包装   字段指定元素右侧所需的边距空间。 如果您选择了   默认  选项，那么将使用 [全局设置](settings-code-style.html#rightMargin)中的右边距值。

### 输入时自动换行

使用   输入时自动换行   设置来指定如何将编辑的文本适应到指定的   在以下位置硬包装   中：

* 默认 ：在这种情况下 CLion 使用了在 [全局设置](settings-code-style.html#wrapOnTyping)中指定的 输入时自动换行 选项。

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

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

### 视觉指南

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

### 在重新格式化时保持

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

### 大括号放置选项

|  项  |  描述  |
| --- | --- |
|  大括号放置风格  |     使用此列表指定  类声明 、  函数声明 和其他类型声明中大括号的放置位置。 可用选项包括：        * 行尾 ：选择此选项将在声明行末放置开括号。    * 下一行如果换行 ：选择此选项，可以在多行声明行之后的行首放置开始大括号。    * 下一行 ：选择此选项，使左大括号放置在声明行后一行的行首。    * 下一行已移动 ：选择此选项，可将左大括号放置在声明行之后的一行，并将其 Shift 至相应的缩进级别。若要在声明行后一行放置左大括号，并 Shift 至相应的缩进级别，请选择此选项。这个翻译包含了额外句子，不应出现。修正如下： 下一行已移动 ：选择此选项，可将左大括号放置在声明行之后的一行，并 Shift 至相应的缩进级别。我的最终答案需要只包含修正后的 JSON。    * 下一行，每行均已移位 ：选择此选项可以使开括号放在声明行的下一行，并且相应地移到相应的缩进级别，并且将下一行移到下一个缩进级别。    |
|  强制使用大括号  |     从这个列表中，为  `if` ，  `for` ，  `while`  和  `do () while`  语句选择大括号介绍方法。 可用选项包括：        * 不要强迫 ：选择此选项，以阻止自动引入大括号。    * 多行时 ：如果语句占用多行，则选择此选项以自动引入括号。 请注意，CLion 分析的是整个声明中的行数，而非仅其条件。 例如，如果代码是 ```CPLUSPLUS int foo (int Days) { if ((Days % 10) == 3) return 1; else return 0; } ``` CLion 将自动插入大括号： ```CPLUSPLUS int foo (int Days) { if ((Days % 10) == 3) { return 1; } else { return 0; } } ```    * 始终 ：勾选此复选框，以始终自动引入大括号。    |

## 空白行

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

|  项  |  描述  |
| --- | --- |
|    保持最大空白行数    |  在此区域，指定在指定位置重新格式化后要保留的空行数。  |
|    最小空白行数    |     在此区域，指定在指定位置应存在的最少空行数。      > **Warning:** > 这些设置并不影响第一项之前和最后一项之后的空行数量。    |

## 新文件扩展名

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

|  项  |  描述  |
| --- | --- |
|  源文件/头文件类型窗格。  |  源文件和头文件类型列表。 在此  设置  节点下指定的所有代码样式规则均适用于列出的文件类型。  |
|  源文件扩展名  |  从下拉列表中选择要与源文件关联的扩展名。  |
|  头文件扩展名  |  从下拉列表中选择要与头文件关联的扩展名。  |
|  文件命名约定  |  从下拉列表中选择首选的命名约定。 此设置定义了在 [新建 C++ 类](creating-files-from-templates.html) 对话框中创建新类时生成的文件名的大小写。  |

|  项  |  快捷方式  |  描述  |
| --- | --- | --- |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/.h 类型。 添加到列表后，从  源文件扩展名/头文件扩展名  下拉列表中分配所需的扩展名。  |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `⌘ ⌦` (Xcode), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (ReSharper), `⌥ ⌦` (ReSharper (macOS)), `Alt+Delete` (QtCreator), `⌘ ⌦` (QtCreator (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  点击此按钮从列表中移除选定的源文件/头文件类型对。  |
|  ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg) ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg)  |  `Alt+Up` (Windows), `⌃ ⇧ ↑` (macOS), `⌃ ↑` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ↑` (macOS System Shortcuts), `Alt+Up` (XWin), `Alt+Up` (GNOME), `Alt+Up` (KDE), `Alt+Up` (Emacs), `Alt+Up` (Sublime Text), `Alt+Up` (Sublime Text (macOS)), `⌥ ↑` (Xcode), `Alt+Up` (Visual Studio), `⌃ ⇧ ↑` (Visual Studio (macOS)), `Alt+Up` (ReSharper), `⌃ ⇧ ↑` (ReSharper (macOS)), `Alt+Up` (QtCreator), `⌃ ⇧ ↑` (QtCreator (macOS)), `Ctrl+Alt+Up` (NetBeans), `Ctrl+Shift+Up` (Eclipse), `⌃ ⌥ ↑` (Eclipse (macOS)) 或 `Alt+Down` (Windows), `⌃ ⇧ ↓` (macOS), `⌃ ↓` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ↓` (macOS System Shortcuts), `Alt+Down` (XWin), `Alt+Down` (GNOME), `Alt+Down` (KDE), `Alt+Down` (Emacs), `Alt+Down` (Sublime Text), `Alt+Down` (Sublime Text (macOS)), `⌥ ↓` (Xcode), `Alt+Down` (Visual Studio), `⌃ ⇧ ↓` (Visual Studio (macOS)), `Alt+Down` (ReSharper), `⌃ ⇧ ↓` (ReSharper (macOS)), `Alt+Down` (QtCreator), `⌃ ⇧ ↓` (QtCreator (macOS)), `Ctrl+Alt+Down` (NetBeans), `Ctrl+Shift+Down` (Eclipse), `⌃ ⌥ ↓` (Eclipse (macOS))  |  使用这些按钮在列表中上下移动选定的源文件/头文件类型对。  |

## 代码生成

|  项  |  描述  |
| --- | --- |
|  通用  |      * 行注释在第一列 ：如果选中此复选框，行注释将对齐到第一列；否则，它们将对齐到代码。    * 块注释在第一列 ：如果选中此复选框，块注释将对齐到第一列；否则，它们将对齐到代码。    * 块注释中新行缩进 ：如果选中此复选框，块代码的每一新行将缩进；否则，它将与块的第一行对齐。    * Const/volatile 限定符位置 。 此设置定义了代码生成期间关键字的顺序。 选择 const int x = 0 单选按钮以将 const/volatile 限定符放在类型说明符之前。 选择 int const x = 0 单选按钮以将 const/volatile 限定符放在类型说明符和符号名称之间。    |
|  C++  |      * 字段前缀 ：输入一个前缀，该前缀将添加到自动生成字段的名称之前。    * 字段后缀 ：输入一个后缀，该后缀将添加到自动生成字段的名称之后。    * Getter 前缀 ：输入一个前缀，该前缀将添加到自动生成 getter 的名称之前。 默认名称为 `get` 。    * Setter 前缀 ：输入一个前缀，该前缀将添加到自动生成 setter 的名称之前。 默认名称为 `set` 。       * 同时生成 != 和 == ：选中此复选框以在生成等式运算符时默认启用此设置，用于 [选择字段对话框](select-fields-dialog.html)。    * 同时生成 >、<=、>= 和 < ：选中此复选框以在生成关系运算符时默认启用此设置，用于 [选择字段对话框](select-fields-dialog.html)。    * 同时插入 "virtual" 属性和 "override" ：选中此复选框以允许在生成继承函数时同时插入 "virtual" 属性和 "override" 修饰符。 此选项适用于 C++11 标准或更高版本。    * 使用 C++ 转换运算符 ：选中时，快速修复将在适当情况下插入 C++ 转换运算符，而不是 C 风格的转换。    |
|  文档注释  |      * 添加 @brief 标签 ：选中此复选框以在 [Doxygen](creating-and-viewing-doxygen-documentation.html) 风格的注释中启用 `@brief` 标签。    * 行注释中的标签前缀 ：点击 @param 或 \param 单选按钮以选择首选的前缀类型。    * 块注释中的标签前缀 ：点击 @param 或 \param 单选按钮以选择首选的前缀类型。    |

## 命名约定

参见 [命名规则](naming-conventions.html)。

