# 代码样式

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

> **TL;DR**
> `文件 | 设置 | 编辑器 | 代码样式`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 编辑器 | 代码样式`  适用于 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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (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)

## 方案

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

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

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

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

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

|  条目  |  描述  |
| --- | --- |
|  方案  |     从此列表中，选择要使用的方案。  预定义的  方案以粗体显示。  自定义  方案，即预定义方案的副本，都是纯文本。 方案存储的位置会写在每个方案旁边，例如，   默认   方案是存储在 IDE 中，   项目   方案是存储在项目中。     |
|  ![显示方案操作](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)  |     点击此按钮以调用用于管理方案的命令列表：        * 复制到 IDE… ：选择此选项将方案设置复制到 IntelliJ IDEA 。 > **Tip:** > 这个选项仅适用于 项目 方案。    * 导出 ：选择此选项以将所选方案导出为 IntelliJ IDEA 代码样式 XML 兀 、 Eclipse XML 配置文件 或 编辑器配置 格式（如果启用了 [EditorConfig](editorconfig.html) 插件）。 > **Tip:** > 此选项可用于 项目 和 IDE 方案。    * 导入方案 ：选择此选项以从指定位置导入选定类型的方案。 > **Tip:** > 此选项可用于 项目 和 IDE 方案。    * 复制项目... : 选择此选项可用所选IDE代码样式方案的设置覆盖您当前的项目代码样式设置。 > **Tip:** > 这个选项仅对 IDE 方案可用。    * 复制… ：选择此选项以创建选定方案的副本。 > **Tip:** > 这个选项仅对 IDE 方案可用。    * 重置 ：选择此选项，将默认或捆绑的配色方案重置为与 IntelliJ IDEA 一起提供的初始默认设置。 只有当一些更改已经完成时，此命令才会变为可用。 > **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)), `Enter` (Visual Studio), `⏎` (Visual Studio (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)), `Escape` (Visual Studio), `⎋` (Visual Studio (macOS)), `Escape` (NetBeans), `Escape` (Eclipse), `⎋` (Eclipse (macOS)) 以取消。 > **Tip:** > 这个选项仅对 IDE 方案可用。    |

## 常规

### 行分隔符

IntelliJ IDEA 允许您为各种语言配置行分隔符和缩进选项。 在 [重新格式化源代码](reformat-and-rearrange-code.html)时，IntelliJ IDEA将应用指定的缩进行为，并跳过用特殊格式关/开标记标注的部分。

|  条目  |  描述  |
| --- | --- |
|  行分隔符  |     使用此列表来指定由 IntelliJ IDEA 创建的文件中要使用哪个 [行分隔符](configuring-line-endings-and-line-separators.html#separator_settings)。 可用选项包括：        * 依赖于系统 ：选择此选项以使用适合您操作系统的默认分隔符。    * Unix 和 macOS ( ) ：选择此选项以使用 Unix 和 macOS 行分隔符。    * Windows ( ) ：选择此选项以使用 Windows 行分隔符。    * 经典 Mac OS ( ) ：选择此选项以使用 `\r` 行分隔符，该分隔符在 [Classic Mac OS](https://en.wikipedia.org/wiki/Classic_Mac_OS)（直至 Mac OS 9）中使用过。    |
|  硬换行位置  |  在此字段中，指定用于在编辑器中显示页面的列数。  |
|  在输入时换行  |  选择此复选框，以确保编辑过的文本始终适应指定的右边距。  |
|  可视化参考线  |  在此字段中，指定多个右边距。 您可以保留默认值，或者输入您的边距所需的空格数。 如果您想要指定多个边距，请输入由顿号分隔的数字。  |

### 缩进检测

选择   检测并使用现有文件缩进进行编辑。   检测当前文件的 [缩进样式](null)，并使用此样式来替代特定语言在代码样式设置中指定的缩进。

IntelliJ IDEA" 在编辑器的状态栏中显示缩进信息。 您可以点击缩进信息以查看可用操作，例如启用或禁用此选项，并将当前缩进更改为特定语言的代码样式设置中指定的缩进。

### 编辑器配置

选择   启用 EditorConfig 支持。   复选框以使用 EditorConfig 进行代码样式。 在这种情况下，您可以指定覆盖 IDE 设置的代码样式设置，并在项目内设定不同的代码样式。

如果您决定在创建 EditorConfig 设置文件后使用 IDE 设置，您需要清除   启用 EditorConfig 支持。   复选框。

## 格式化器

在此区域中，指定标记以限制您希望排除从 [重新格式化](reformat-and-rearrange-code.html) 的代码片段。 在源代码中，格式标记写在 [行注释](working-with-source-code.html#editor_lines_code_blocks)中。

|  条目  |  描述  |
| --- | --- |
|    不进行格式设置。​    |     在   不进行格式设置。​   字段中，指定一个 [glob 模式](https://en.wikipedia.org/wiki/Glob_(programming))，其中包含要从 [重新格式化](reformat-and-rearrange-code.html)、 [代码排列](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)  |

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

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

## See also

### 过程

[代码样式方案](configuring-code-style.html)