# 重新格式化代码

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

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

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

Procedure: 格式化代码片段

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

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

在重新格式化之前，您可以查看应用于所选代码的代码样式设置：按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) 并点击   调整代码样式设置  。

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)), `Ctrl+Alt+Enter` (Visual Studio), `⌘ ⌥ ⏎` (Visual Studio (macOS)), `Alt+Shift+F` (NetBeans), `Ctrl+Alt+L` (Eclipse), `⌘ ⇧ F` (Eclipse (macOS))。

或者，在显示的 [工具栏](working-with-source-code.html#floating_toolbar)上点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.actions.reformatCode.svg)   重新格式化代码  。

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)), `Ctrl+Alt+Shift+L` (Visual Studio), `⌘ ⌥ ⇧ L` (Visual Studio (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` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS))并选择额外的文件进行分组格式化。

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

* 优化导入 ：如果您希望删除未使用的导入、添加缺失的导入或整理导入语句，请选择此选项。 有关更多信息，请参阅 [优化导入](creating-and-optimizing-imports.html#optimize-imports) 部分。

* 重排条目 ：如果您需要根据代码样式设置中指定的 [排列规则](rearrange-code.html) 重新排列代码，请选择此选项。

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

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

3. 点击   运行  。

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

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

Procedure: 重新格式化模块或目录

1. 在   项目  工具窗口中，右键点击模块或目录并选择   重新格式化代码  或按 `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)), `Ctrl+Alt+Enter` (Visual Studio), `⌘ ⌥ ⏎` (Visual Studio (macOS)), `Alt+Shift+F` (NetBeans), `Ctrl+Alt+L` (Eclipse), `⌘ ⇧ F` (Eclipse (macOS))。

2. 在打开的对话框中，指定 [重新设置格式的选项](#reformat_options)。

3. 或者，您可以应用筛选器：

* 您可以选择要处理的文件 [作用域](configuring-scopes-and-file-colors.html)。

* 或者，您可以通过启用 文件掩码(s) 复选框，将重新格式化范围缩小到特定文件类型。 文件掩码(s) 选项可帮助缩小要处理的文件范围。 使用通配符指定一个或多个文件名称模式，以匹配要包含的文件。 使用逗号分隔多个文件掩码。 了解详情，请参阅 [在特定文件类型中搜索](finding-and-replacing-text-in-project.html#exclude_type)。

![模块或目录重格式化对话框](https://resources.jetbrains.com/help/img/idea/2026.3/module_directory_reformat.png)

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)), `Ctrl+Alt+I` (Visual Studio), `⌃ ⌥ I` (Visual Studio (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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，转到  `编辑器 | 代码风格` 。 选择您要更改缩进的语言。

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

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

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (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)), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (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. 在   提交检查   菜单下，启用   重新格式化代码   选项。

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

![在提交时重新格式化代码](https://resources.jetbrains.com/help/img/idea/2026.3/reformat_on_commit.png)

Procedure: 从命令行重新格式化代码

IntelliJ IDEA 可以从命令行将代码样式格式设置应用于指定文件。

1. 确保有适用于操作系统的命令行启动器。

2. 运行  `format`  命令。

有关更多信息，请参阅 [从命令行格式化文件](command-line-formatter.html)。

Procedure: 排除文件格式化

您可以从重新格式化、 [代码排列](rearrange-code.html)和 [导入优化](creating-and-optimizing-imports.html#optimize-imports)中排除一组文件和目录。

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (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)), `Ctrl+Alt+/` (Visual Studio), `⌘ ⌥ /` (Visual Studio (macOS)), `Ctrl+/` (NetBeans), `Ctrl+/` (Eclipse), `⌘ /` (Eclipse (macOS))并输入  `@formatter:off` 。 在该区域的末尾，创建另一行注释并输入  `@formatter :on` 。

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

![格式标记](https://resources.jetbrains.com/help/img/idea/2026.3/ij_formatting_markers_example.png)

## 使用格式化标记的示例

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/code-formatting-markers.mp4)

Procedure: 保留现有格式设置

您可以选择在重新格式化代码时被忽略的格式化规则。 例如，您可以调整 IDE 以保持简单的方法和函数在一行上，而通常情况下，在代码重新格式化后，它们会扩展为多行。

1. 在主菜单中，转到  `设置 | 编辑器 | 代码样式` ，选择您的编程语言，然后打开   换行和大括号  标签。

2. 在   重新格式化时保留   部分中，选择希望 IDE 在重新格式化期间保留的现有格式设置类型。 清除希望 IDE 根据当前代码样式应用的格式设置对应的复选框。

3. [重新格式化您的代码](#reformat_code) ( `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)), `Ctrl+Alt+Enter` (Visual Studio), `⌘ ⌥ ⏎` (Visual Studio (macOS)), `Alt+Shift+F` (NetBeans), `Ctrl+Alt+L` (Eclipse), `⌘ ⇧ F` (Eclipse (macOS))).

IntelliJ IDEA 将根据当前的样式设置重新格式化您的代码，并保留您选择的规则的现有格式。

## 格式化程序设置

要访问设置，请在   设置   对话框（ `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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，转到  `编辑器 | 代码风格` ，并切换到   格式化器   选项卡。

|  条目  |  描述  |
| --- | --- |
|    不进行格式设置。​    |     在   不进行格式设置。​   字段中，指定一个 [glob 模式](https://en.wikipedia.org/wiki/Glob_(programming))，其中包含要从 [重新格式化]()、 [代码排列](null)和 [导入优化](creating-and-optimizing-imports.html#optimize-imports) 中排除的文件和目录名称，例如：  `*.{html,htm}` 。       您可以指定用分号  `;`  分隔的几个通配符模式。       使用星号  `*`  通配符来完全禁用重新格式化。     |
|    通过代码注释中的标记来开启或关闭格式化程序。    |      * 如果启用此选项，将根据这些标记重新格式化带有格式化标记的行注释之间的代码片段：带有开启标记的代码片段将被重新格式化，而带有关闭标记的片段在您重新格式化代码后将保持不变。 参见 [使用格式化标记的示例](#formatting-markers-usage-example)。 在您勾选此复选框后，下方的字段将变为可用状态，您可以指定需要被视为格式标记的字符串。    * 如果禁用此选项，将忽略格式标记，带标记的行注释之间的代码将被重新格式化。    |
|    关闭：    |  在此字段中，指定将表示您希望从重新格式化中排除的代码片段起始的字符字符串。 在前置词中键入带有  `@`  符号的字符字符串，或保留预定义的值  `@formatter:off` 。  |
|    开启：    |     在此字段中，指定将表示要从重新格式化中排除的代码片段结束的字符字符串。 在前置词中键入带有  `@`  符号的字符字符串，或保留预定义的值  `@formatter:on` 。     |
|    在格式化程序标记中启用正则表达式    |     选择此复选框，使用正则表达式替代显式指定的格式标记。 IntelliJ IDEA 会使用指定的正则表达式来匹配格式化开/关标记，而不是精确的字符串。       例如，使用正则表达式可以让您有多个启用格式化器和禁用它的标记。 在这种情况下，您可以使用以下正则表达式：  `@formatter:(off\|disable\|no)`  和  `@formatter:(on\|enable\|yes)` 。       参见 [使用格式化标记的示例](#formatting-markers-usage-example) 查看演示。      ![使用不同格式化标记的示例](https://resources.jetbrains.com/help/img/idea/2026.3/different_formatter_markers.png)  |

## See also

### 过程

[编辑器配置](editorconfig.html) [Code style schemes](configuring-code-style.html)

### 参考

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

