# 代码格式化

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

CLion 可根据您在当前 [代码样式方案](configuring-code-style.html#configure-code-style-schemes)或 [.editorconfig](editorconfig.html) 文件中指定的要求重新格式化代码。 如果在  `.editorconfig`  未定义任何内容，则将从项目设置中获取。

您可以重新格式化部分代码、整个文件、一组文件、一个目录和一个模块。 您还可以从重新格式化中排除部分代码或某些文件。

Procedure: 格式化代码片段

1. 在编辑器中选择您要重新格式化的代码片段。

> **Note:**
> 如果您未选择代码片段，CLion 将重新格式化整个文件。

2. 在主菜单中，前往  `代码 | 格式化代码` 或按下 `Ctrl+Alt+L` (Windows), `⌘ ⌥ L` (macOS), `⌘ ⌥ L` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ L` (macOS System Shortcuts), `Ctrl+Alt+L` (XWin), `Ctrl+Alt+L` (GNOME), `Alt+Shift+L` (KDE), `Ctrl+Alt+L` (Emacs), `Ctrl+Alt+L` (Sublime Text), `⌘ ⌥ L` (Sublime Text (macOS)), `⌘ ⌥ L` (Xcode), `Ctrl+Alt+Enter` (Visual Studio), `⌘ ⌥ ⏎` (Visual Studio (macOS)), `Ctrl+Alt+L` (ReSharper), `⌘ ⌥ L` (ReSharper (macOS)), `Ctrl+;` (QtCreator), `⌘ ;` (QtCreator (macOS)), `Alt+Shift+F` (NetBeans), `Ctrl+Alt+L` (Eclipse), `⌘ ⇧ F` (Eclipse (macOS))。

> **Note:**
> 如果  `代码 | 格式化代码`  看起来没有任何效果，通常表示格式化程序工作正常——您的代码已符合当前启用的样式。 对于 C/C++，请检查当前启用的是哪种样式：
>
>
>
> * 启用 ClangFormat 支持 后（ `设置 | 编辑器 | 代码样式 | C/C++` ），CLion 会遵循 `.clang-format` ，并忽略 IDE 代码样式和 JetBrains 专用的 `ij_*` EditorConfig 密钥。
>
> * 禁用后，CLion 会使用其内置格式化程序，该格式化程序由 `代码样式` 设置或 `.editorconfig` 驱动，并忽略 `.clang-format` 。
>
>
>
> 当这两个配置不一致时，由一个引擎进行格式设置的代码在另一个引擎看来可能已经正确，因此   重新格式化代码   不会产生可见变化。

Procedure: 重新格式化文件

1. 在编辑器中打开文件并按下 `Ctrl+Alt+Shift+L` (Windows), `⌘ ⌥ ⇧ L` (macOS), `⌘ ⌥ ⇧ L` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ L` (macOS System Shortcuts), `Ctrl+Alt+Shift+L` (XWin), `Ctrl+Alt+Shift+L` (GNOME), `Ctrl+Alt+Shift+L` (KDE), `Ctrl+Alt+Shift+L` (Emacs), `Ctrl+Alt+Shift+L` (Sublime Text), `⌘ ⌥ ⇧ L` (Sublime Text (macOS)), `⌘ ⌥ ⇧ L` (Xcode), `Ctrl+Alt+Shift+L` (Visual Studio), `⌘ ⌥ ⇧ L` (Visual Studio (macOS)), `Ctrl+Alt+Shift+L` (ReSharper), `⌘ ⌥ ⇧ L` (ReSharper (macOS)), `Ctrl+Alt+Shift+L` (QtCreator), `⌘ ⌥ ⇧ L` (QtCreator (macOS)), `Ctrl+Alt+Shift+L` (NetBeans), `Ctrl+Alt+Shift+L` (Eclipse), `⌘ ⌥ ⇧ L` (Eclipse (macOS))，或在   项目   工具窗口中右键点击文件并选择  `重新格式化代码` 。

> **Note:**
> 持续按住 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Xcode), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (ReSharper), `Shift` (ReSharper (macOS)), `Shift` (QtCreator), `Shift` (QtCreator (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS))并选择额外的文件进行分组格式化。

2. 在打开的   [重新格式化文件](null)   对话框中，您可以根据需要选择以下重新格式化选项：

![重新格式化文件对话框](https://resources.jetbrains.com/help/img/idea/2026.3/cl_reformat_files.png)

* 代码清理 ：选择此选项以运行代码清理检查。

* 不要保留换行符 ：根据代码样式设置重新格式化换行符。 此选项仅当在 `设置 | 编辑器 | 代码样式 | <语言> | 换行和大括号` 中为当前语言启用 `重新格式化时保留 | 换行符` 时可用。 如果选择 不要保留换行符 ，IDE 会临时重写该设置，并根据当前代码样式移除现有换行。 还可以使用 [再次重新格式化以移除自定义换行](settings-smart-keys.html#remove-custom-line-breaks) 选项（位于 `设置 | 编辑器 | 智能键` 中）。

3. 点击   运行  。

如果您想查看代码在重新格式化期间所做的确切更改，请使用 [本地历史记录](local-history.html) 功能。

Procedure: 重新格式化行缩进

您可以根据指定的设置重新格式化行缩进。

1. 在编辑器中，选择必要的代码片段并按 `Ctrl+Alt+I` (Windows), `⌃ ⌥ I` (macOS), `⌘ ⌥ I` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ I` (macOS System Shortcuts), `Ctrl+Alt+I` (XWin), `Ctrl+Alt+I` (GNOME), `Ctrl+Alt+I` (KDE), `Ctrl+Alt+I` (Emacs), `Ctrl+Alt+I` (Sublime Text), `⌃ ⌥ I` (Sublime Text (macOS)), `⌃ I` (Xcode), `Ctrl+Alt+I` (Visual Studio), `⌃ ⌥ I` (Visual Studio (macOS)), `Ctrl+Alt+I` (ReSharper), `⌃ ⌥ I` (ReSharper (macOS)), `Ctrl+I` (QtCreator), `⌘ I` (QtCreator (macOS)), `Ctrl+Alt+I` (NetBeans), `Ctrl+I` (Eclipse), `⌘ I` (Eclipse (macOS))。

2. 如果您需要调整缩进设置，请在   设置   对话框（ `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))）中，转到  `编辑器｜代码样式` 。 选择您要更改缩进的语言。

3. 在   制表符和缩进  选项卡上，指定适当的缩进选项，然后点击   确定  。

> **Note:**
> [自动缩进检测](indentation.html#detect-indentation) 可以重写在   制表符和缩进   选项卡上配置的缩进。 在这种情况下，CLion 会显示通知。

Procedure: 保存时自动重新格式化代码

您可以配置 IDE，在修改文件的代码在更改 [保存](saving-and-reverting-changes.html)时自动重新格式化。

1. 按下 `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)) 打开设置，然后选择  `工具 | 保存时的操作` 。

2. 启用   重新设置代码格式   选项。

3. 此外，您可以配置 IDE 重新格式化代码的方式：

* 点击 配置作用域… 以指定您要 [排除在重新格式化之外](#exclude_file_from_reformat)的文件名和目录的模式。

* 从 所有文件类型 列表中选择您要重新格式化代码的文件类型。

* 如果您的项目在版本控制中，请选择 整文件 或 更改的行数 。 如果您选择 更改的行数 ，代码重格式化将仅适用于本地更改但尚未提交到存储库的代码行。

Procedure: 在提交时重新格式化代码

如果您的项目在 [版本控制](version-control-integration.html)下，您可以在提交更改到存储库时自动重新格式化代码。 在这种情况下，仅会重新格式化新增或修改的代码。

> **Note:**
> 此功能仅适用于 [Git](using-git-integration.html) 和 [Mercurial](using-mercurial-integration.html)。

1. 按 `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))打开   提交  工具窗口，然后点击   显示提交选项   ![设置按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)。

2. 在   提交检查   菜单下，启用   重新设置代码格式   选项。

启用该选项后，每次提交时，新增或修改的代码都会被重新格式化。

Procedure: 排除文件格式化

您可以将一组文件和目录排除在重新格式化和导入优化之外。

1. 在   设置  对话框 ( `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))) 中，前往  `编辑器｜代码样式` 。

2. 切换到   格式化器  选项卡，在   不要进行格式设置。  字段中，使用 [glob 模式](https://en.wikipedia.org/wiki/Glob_(programming))输入您想要排除的文件和目录。

您可以指定用分号  `;`  分隔的几个通配符模式。 如果您点击 ![展开图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.inline.expand.svg)，该字段将展开，每个模式将显示在单独的行上。

> **Tip:**
> 输入星号  `*` 通配符以完全禁用重新格式化。

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

![指定一个 glob 模式以排除文件格式化](https://resources.jetbrains.com/help/img/idea/2026.3/reformat-glob-pattern.png)

Procedure: 在编辑器中排除代码片段的重格式化

1. 在   设置  对话框 ( `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))) 中，前往  `编辑器｜代码样式` 。

2. 切换到   格式化器  标签并启用   在代码注释中使用标记开启或关闭格式化程序  选项。

3. 在编辑器中，您希望排除的区域开头创建行注释 `Ctrl+/` (Windows), `⌘ /` (macOS), `⌘ /` (IntelliJ IDEA Classic (macOS)), `⌘ /` (macOS System Shortcuts), `Ctrl+/` (XWin), `Ctrl+/` (GNOME), `Ctrl+/` (KDE), `Alt+;` (Emacs), `Ctrl+/` (Sublime Text), `⌘ /` (Sublime Text (macOS)), `⌘ /` (Xcode), `Ctrl+Alt+/` (Visual Studio), `⌘ ⌥ /` (Visual Studio (macOS)), `Ctrl+/` (ReSharper), `⌘ /` (ReSharper (macOS)), `Ctrl+/` (QtCreator), `⌘ /` (QtCreator (macOS)), `Ctrl+/` (NetBeans), `Ctrl+/` (Eclipse), `⌘ /` (Eclipse (macOS))并输入  `@formatter:off` 。 在该区域的末尾，创建另一行注释并输入  `@formatter :on` 。

标记之间的代码不会重新格式化。

## See also

### 流程

[EditorConfig 配置](editorconfig.html) [Code style schemes](configuring-code-style.html)

### 参考

[Settings | Code Style](settings-code-style.html)

### JetBrains 博客文章

[Recent code formatter updates](https://blog.jetbrains.com/clion/2025/08/clion-2025-2-release/#reworked-code-formatter)

