代码样式。 Kotlin

使用此页面配置 Kotlin 文件的格式选项。当您更改这些设置时，预览面板将显示这将如何影响您的代码。

制表符和缩进

条目	描述
使用制表符	请使用 `Tab` 键进行缩进。当复选框未勾选时， IntelliJ IDEA 使用空格而非制表符。
智能制表符	如果选中此复选框，则嵌套代码块的缩进将根据需要使用制表符和空格，而对齐缩进则仅使用空格。如果此复选框未选中，将只使用选项卡。这意味着一组符合指定制表符大小的空格将自动替换为一个制表符，这可能会导致精细对齐的破坏。智能制表符复选框在启用使用制表符选项时可用。
制表符大小	在此字段中，指定一个选项卡中包含的空格数。
缩进	在此字段中，指定为每个缩进级别插入的空格数量。
连续缩进	指定从前一行延续的行的缩进，使其清晰地表示它们是同一语句或代码块的一部分。当单个语句过长而无法放在一行中时，使用续行缩进。
空行时保持缩进	如果选中此复选框，IntelliJ IDEA 将会保持空行的缩进，就像它们包含了一些代码一样。如果取消勾选此复选框，IntelliJ IDEA 将删除制表符和空格。

空格

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

包装和大括号

在此选项卡中，自定义代码样式选项，IntelliJ IDEA 将在重新格式化源代码时应用。左侧窗格包含异常列表（重新设置格式时保持），以及各种代码结构（列表、语句、操作、注解等）的放置和对齐选项。右侧窗格显示预览。

对齐设置优先于缩进选项。

在以下位置硬包装

使用强制换行位置字段指定元素右侧所需的边距空间。如果您选择了默认选项，那么将使用全局设置中的右边距值。

输入时自动换行

使用键入时换行设置来指定如何将编辑的文本适应到指定的强制换行位置中：

默认：在这种情况下，IntelliJ IDEA 使用的是键入时换行选项，该选项在全局设置中指定。
是：在这个例子中，IntelliJ IDEA 使用了在右边距字段里指定的值。
否：在这种情况下，此选项被关闭，一行可以超过右侧边距指定的值。

视觉指南

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

在重新格式化时保持

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

包装选项

换行样式应用于左侧窗格中指定的各种代码构造（例如，方法调用参数、方法声明参数或赋值语句）。

条目	描述
包装风格	从这个列表中，选择您想要的换行样式：不换行：当选择此选项时，不会应用任何特殊的换行样式。选择此选项后，将忽略嵌套对齐和大括号设置。过长则换行：选择此选项可以让超出右边界的行以正确的缩进进行折叠。始终换行：选择此选项以包装所有列表中的元素，使每行只有一个元素，并具有适当的缩进。如果过长则截断：选择此选项可将超出右边距的列表中的元素进行换行，以便每行一个元素并带有适当的缩进。

对齐选项

条目	描述
多行时对齐	如果选中此复选框，代码构造将在每一行的同一列开始。否则，代码结构的位置由当前的缩进级别确定。

空白行

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

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

导入

条目	描述
顶级符号	使用此区域定义如何导入顶级符号。可能的选项有：使用单名称导入：如果选择了此选项，只有在代码生成或导入优化期间从包中导入特定声明。使用 import 带‘' ：如果选择了此选项，将插入一条导入整个包的声明。仅当使用的名称至少为 <n> 时使用带有 '' 的导入：如果选择了此选项，请指定从单一包中导入的声明数，直到所有导入单一声明的语句都被替换为导入整个包的语句。
Java 静态成员和枚举成员	使用此区域定义如何导入 Java 静态文件和枚举。
其他	使用此区域定义如何导入其他符号。插入嵌套类的导入: 如果选中此复选框，IntelliJ IDEA 将为代码中引用的嵌套类创建导入。如果未选择此选项，IntelliJ IDEA 会为顶级类生成导入，并使用其顶级类的名称来修饰嵌套类的名称。
使用 '*' 导入的包	按照以下方式使用表格：软件包：在此列的文本字段中，指定要导入的包。使用子软件包：选中此复选框，让 IntelliJ IDEA 导入所选包的所有子包。

其他

条目	描述
使用尾随逗号	在一系列元素的最后一项后添加逗号符号。 class Person( val firstName: String, val lastName: String, val age: Int, // trailing comma ) Kotlin 风格指南鼓励在声明位置使用尾部逗号，并将其留给您在调用位置自行决定。有关更多信息，请参考 Kotlin 编码规范。

条目

描述

使用尾随逗号

在一系列元素的最后一项后添加逗号符号。

                        class Person(
                            val firstName: String,
                            val lastName: String,
                            val age: Int, // trailing comma
                        )
                    
     

Kotlin 风格指南鼓励在声明位置使用尾部逗号，并将其留给您在调用位置自行决定。有关更多信息，请参考 Kotlin 编码规范。

代码生成

条目	描述
注释代码	在此区域配置生成注释的代码样式（行 `Ctrl+/` 和块 `Ctrl+Shift+/`）：行注释在第一列：在第一列开始行注释（`Ctrl+/`）。如果您禁用此选项，注释将与您的代码对齐。在注释开头添加一个空格：在行注释字符和被注释行的第一个字符之间插入一个空格。重新设置格式时强制：在现有评论中，当您正在重新格式化代码时，将空格插入行注释字符和被注释行的第一个字符之间。请注意，第一个字符必须是字母数字符号，否则不会插入空格。例如，reformatter 将会忽略 `//&Lorem ipsum` 的评论。当在注释开头添加一个空格被启动时，此选项变为可用。注释块在第一列：在第一列开始块注释（`Ctrl+Shift+/`）。如果您禁用此选项，注释将与您的代码对齐。在块注释周围添加空格：在块注释字符和被注释文本的第一个字符之间插入一个空格。

条目

描述

注释代码

在此区域配置生成注释的代码样式（行 Ctrl+/ 和块 Ctrl+Shift+/）：

行注释在第一列：在第一列开始行注释（Ctrl+/）。如果您禁用此选项，注释将与您的代码对齐。
在注释开头添加一个空格：在行注释字符和被注释行的第一个字符之间插入一个空格。
重新设置格式时强制：在现有评论中，当您正在重新格式化代码时，将空格插入行注释字符和被注释行的第一个字符之间。请注意，第一个字符必须是字母数字符号，否则不会插入空格。例如，reformatter 将会忽略 //&Lorem ipsum 的评论。
当在注释开头添加一个空格被启动时，此选项变为可用。
注释块在第一列：在第一列开始块注释（Ctrl+Shift+/）。如果您禁用此选项，注释将与您的代码对齐。
在块注释周围添加空格：在块注释字符和被注释文本的第一个字符之间插入一个空格。

设置自...

点击此链接，显示用作当前语言代码样式基础的语言列表。只有适用于当前语言的设置才会被采用。所有其他设置均不受影响。

此链接会在适用时出现在语言特定代码样式页面的右上角。

点击重置以放弃更改并返回至初始的代码样式设置。

最后修改日期： 2025年 4月 24日