# 编辑器配置

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

IntelliJ IDEA 允许您通过 [EditorConfig](https://editorconfig.org/) 支持来管理每个文件集的所有代码样式设置。

Procedure: 启用 EditorConfig 插件

此功能性依赖于 [EditorConfig](https://plugins.jetbrains.com/plugin/7294-editorconfig) 插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

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. 找到  EditorConfig  插件并点击   启用  。

您只需要将一个  `.editorconfig`  文件放入包含您想要定义代码风格的文件的根目录。 如果项目中有多种代码样式（例如用于测试和用于生产代码），则可以在项目中的相应文件夹中拥有多个  `.editorconfig`  文件。 这样，您可以同时遵循多种代码样式标准。

> **Note:**
> 请注意，虽然通常会在根目录保留一个  `.editorconfig`  文件，但文件可以放置在任何层级，并且可以在不同文件夹中使用不同的  `.editorconfig`  文件。 如果文件夹层次结构中有多个  `.editorconfig`  文件，则离所编辑文件最近的文件优先级最高，其余选项会从其他文件合并进来。 请参阅 [EditorConfig](https://editorconfig.org/) 文档了解详情。

`.editorconfig`  文件中的所有选项都会应用于它所在的目录以及所有子目录，并覆盖当前项目的代码样式。 如果父目录中的  `.editorconfig`  或其他  `.editorconfig`  文件中没有定义任何内容，则会从当前 [代码风格方案](configuring-code-style.html) 中获取。 有关未定义 (  `unset` ) 属性的更多信息，请参阅 [EditorConfig](https://editorconfig.org/) 文档。

`.editorconfig`  文件中的所有选项分为以下几类：

* [标准选项](https://github.com/editorconfig/editorconfig/wiki/EditorConfig-Properties) 例如 `indent_size` 、 `indent_style` 等等。 这些选项没有任何特定领域的前缀。

* 适用于所有语言且带有 `ij_` 前缀的通用 IntelliJ 选项： * `ij_visual_guides` * `ij_formatter_off_tag` * `ij_formatter_on_tag` * `ij_formatter_tags_enabled` * `ij_wrap_on_typing` * `ij_continuation_indent_size` * `ij_smart_tabs`

* 许多（但不是全部）语言都支持通用 IntelliJ 选项。 它们以 `ij_any` 前缀开头，例如 `ij_any_brace_style` 。

* IntelliJ 特定语言的选项从 `ij_<lang>_` 前缀开始，其中 `<lang>` 是语言域 ID（通常是小写语言名称），例如， `ij_java_blank_lines_after_imports` 。

所有 IntelliJ  `.editorconfig`  属性在 [代码风格方案](configuring-code-style.html) 中有对应的选项，并且具有类似的名称。

> **Note:**
> 相同的选项可以被定义为通用选项和特定语言选项，例如，  `ij_<...>_brace_style` 。 语言特定选项的优先级高于通用或泛型选项。

Procedure: 添加一个.editorconfig文件

1. 在   项目   工具窗口 ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))) 中，右键点击包含要定义代码样式的文件的源目录，然后从上下文菜单中选择  `新建 | EditorConfig` 。

2. 选择您想要定义的属性，以便 IntelliJ IDEA 为它们创建存根，或者将所有复选框留空以手动添加所需的属性。

> **Tip:**
> 在填写  `.editorconfig` 文件时使用代码补全。

3. 要预览代码样式设置的更改将如何影响实际源文件，请点击 ![眼睛图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.show.svg)文件的页边空白处的  `.editorconfig` 并选择您想要预览更改的源文件。 预览将在右侧打开。

请确保您选择的文件与您点击 ![眼睛图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.show.svg) 旁边的掩码相对应。 例如，要预览  `[*.java]`  文件，预览文件应具有  `.java`  扩展名。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/ij_editor_config_visual_guides.mp4)

您可以在预览窗格中进行更改，以试验和测试您的配置更改如何反映，而无需担心对源代码进行不必要的更改：当您关闭  `.editorconfig` 文件时，所有这些更改都会被丢弃。

4. 重新格式化您的代码。 您可以重新格式化 [代码段](reformat-and-rearrange-code.html#reformat_code)、 [文件](reformat-and-rearrange-code.html#reformat_file)或 [目录中的所有文件](reformat-and-rearrange-code.html#reformat_module_directory)。

或者，可以将 IDE 配置为 [在保存时重新格式化代码](reformat-and-rearrange-code.html#reformat-on-save)。

要快速了解当前在编辑器中打开的文件是否有任何代码样式选项被  `.editorconfig`  文件中的属性重写，请使用状态栏中的缩进微件。

微件中的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.ide.configFile.svg) 图标表示存在一个  `.editorconfig`  文件，该文件重写了当前代码样式方案中的某些设置。

![具有 EditorConfig 图标的缩进小部件](https://resources.jetbrains.com/help/img/idea/2026.3/editorconfig-widget.png)

点击小部件：

* 点击 打开 .editorconfig 以打开最近影响到您当前工作文件的 `.editorconfig` 文件。

* 选择 显示与项目相关的文件… 以打开项目中所有 `.editorconfig` 文件的列表。

* 点击 禁用 EditorConfig 以在您的项目中禁用 EditorConfig 支持并使用当前代码样式方案中的设置。 [您还可以在设置中禁用 EditorConfig 支持](#disable-editorconfig)。

![从缩进微件打开的 EditorConfig 菜单](https://resources.jetbrains.com/help/img/idea/2026.3/editorconfig-widget-menu.png)

Procedure: 将代码样式导出到 .editorconfig 文件

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. 选择您要导出的代码样式   方案  ： [项目](configuring-code-style.html#project-scheme)方案或 [IDE 级方案](configuring-code-style.html#default-scheme)之一。

3. 点击 ![显示方案操作按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)，选择   导出  ，然后   EditorConfig 文件  。

![将代码样式设置导出为 .editorconfig 文件](https://resources.jetbrains.com/help/img/idea/2026.3/ij_export_editorconfig.png)

4. 指定您要保存文件的文件夹。

要导入  `.editorconfig`  文件中的代码样式设置，请将该文件拖到   项目   工具窗口 ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))) 或  `视图 | 工具窗口 | 项目` ) 中所需的文件夹。

Procedure: 禁用 EditorConfig 支持

如果您决定在创建  `.editorconfig` 设置文件后使用 IDE 设置，您可以禁用 EditorConfig 支持，而无需从项目中删除已创建的  `.editorconfig` 文件。

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. 清除   启用 EditorConfig 支持。   复选框。

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

## See also

### 过程

[Code style schemes](configuring-code-style.html) [Reformat code](reformat-and-rearrange-code.html)

### 参考

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

