llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

代码样式。 Go

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

制表符和缩进

缩进宽度按 Space 数衡量,而不是按制表符字符数衡量。 例如,当选择 使用制表符 时,缩进为 4 且制表符大小为 4 会使用一个制表符。

条目

描述

使用制表符

使用 Tab 密钥进行缩进。 当复选框未勾选时, IntelliJ IDEA 使用空格而非制表符。 默认情况下,此复选框已选中。

智能制表符

  • 如果选中此复选框,嵌套代码块的缩进将根据需要使用制表符和 Space,而对齐缩进将仅使用 Space。

  • 如果此复选框未选中,将只使用选项卡。 这意味着一组符合指定制表符大小的空格将自动替换为一个制表符,这可能会导致精细对齐的破坏。

智能制表符 复选框在启用 使用制表符 选项时可用。 默认情况下,此复选框未选中。

选项卡大小

在此字段中,指定一个制表符包含的 Space 数。 默认值: 4。

缩进

在此字段中,指定为每个缩进级别插入的空格数量。 默认值: 4。

连续缩进

指定从上一行延续的行的缩进,以明确它们属于同一语句或代码块。 当单个语句过长而无法放在一行时,将使用连续缩进。

默认值: 4。

保持空行的缩进

如果选中此复选框,IntelliJ IDEA 将会保持空行的缩进,就像它们包含了一些代码一样。

如果取消勾选此复选框,IntelliJ IDEA 将删除制表符和空格。

默认情况下,此复选框未选中。

换行和大括号

配置换行选项和大括号的使用。

条目

描述

硬换行位置

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

在输入时换行

使用 在输入时换行 设置来指定如何将编辑的文本适应到指定的 硬换行位置 中:

  • 默认 :在这种情况下,IntelliJ IDEA 使用 在输入时换行 选项,该选项在 全局设置 中指定。

  • 是 :在这个例子中,IntelliJ IDEA 使用了在 右边距 字段里指定的值。

  • 否 :在这种情况下,此选项被关闭,一行可以超过右侧边距指定的值。

可视化参考线

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

函数调用实参

选择函数调用参数的换行选项。 在 Go 中,函数调用参数是在调用函数时传递给函数的值。

您可以在以下选项之间进行选择:

  • 不换行 :当选中此选项时,不会应用任何特定的换行样式,嵌套对齐和括号设置将被忽略。

  • 过长时换行 :选择此选项可以让超出右边界的行以正确的缩进进行折叠。

  • 始终换行 :选择此选项,可将列表中的所有元素设为已包装,使每行包含一个元素并具有适当的缩进。

  • 过长时分行 :选择此选项,可将列表中超出右边距的元素设为已包装,使每行包含一个元素并具有适当的缩进。

您可以将之前的选项应用于开启和关闭的括号:

  • '(' 后换行 :在开头的括号后面添加新的一行。

  • 将“)”放在新的一行 :在关闭括号前添加新行。

复合文字

选择复合字面量的换行选项。 在 Go 中,复合字面量是创建复合类型值的紧凑表示法,包括数组,切片,映射和结构体。

您可以在以下选项之间进行选择:

  • 不换行 :当选中此选项时,不会应用任何特定的换行样式,嵌套对齐和括号设置将被忽略。

  • 过长时换行 :选择此选项可以让超出右边界的行以正确的缩进进行折叠。

  • 始终换行 :选择此选项,可将列表中的所有元素设为已包装,使每行包含一个元素并具有适当的缩进。

  • 过长时分行 :选择此选项,可将列表中超出右边距的元素设为已包装,使每行包含一个元素并具有适当的缩进。

您可以将之前的选项应用于开启和关闭的括号:

  • '(' 后换行 :在开头的括号后面添加新的一行。

  • 将“)”放在新的一行 :在关闭括号前添加新行。

函数参数

选择函数参数的换行选项。 在 Go 中,函数参数是作为函数签名部分声明的变量,当函数被调用时,用于传递数据到函数。 将作为参数传递给函数的值赋予函数的参数,让函数可以操作数据。

您可以在以下选项之间进行选择:

  • 不换行 :当选中此选项时,不会应用任何特定的换行样式,嵌套对齐和括号设置将被忽略。

  • 过长时换行 :选择此选项可以让超出右边界的行以正确的缩进进行折叠。

  • 始终换行 :选择此选项,可将列表中的所有元素设为已包装,使每行包含一个元素并具有适当的缩进。

  • 过长时分行 :选择此选项,可将列表中超出右边距的元素设为已包装,使每行包含一个元素并具有适当的缩进。

您可以将之前的选项应用于开启和关闭的括号:

  • '(' 后换行 :在开头的括号后面添加新的一行。

  • 将“)”放在新的一行 :在关闭括号前添加新行。

函数结果参数

选择函数/方法结果形参的换行选项。 在 Go 中,结果形参位于函数/方法签名中的形参列表之后。 这些形参定义函数/方法返回的值。

您可以在以下选项之间进行选择:

  • 不换行 :当选中此选项时,不会应用任何特定的换行样式,嵌套对齐和括号设置将被忽略。

  • 过长时换行 :选择此选项可以让超出右边界的行以正确的缩进进行折叠。

  • 始终换行 :选择此选项,可将列表中的所有元素设为已包装,使每行包含一个元素并具有适当的缩进。

  • 过长时分行 :选择此选项,可将列表中超出右边距的元素设为已包装,使每行包含一个元素并具有适当的缩进。

您可以将之前的选项应用于开启和关闭的括号:

  • '(' 后换行 :在开头的括号后面添加新的一行。

  • 将“)”放在新的一行 :在关闭括号前添加新行。

导入

为 import 部分配置代码样式规则。

条目

描述

对 import 使用反引号

将双引号替换为反引号。

已启用

已禁用

go_use_backquotes_for_imports_cleared
对 import 使用反引号

为单个 import 添加括号

在单个 import 声明周围添加圆括号。

删除多余的导入别名

当导入别名与软件包限定符匹配且不需要其他限定符时,将其移除。 例如, logrus 别名会从以下导入条目中移除:

import ( logrus "github.com/sirupsen/logrus" )

排序类型

选择用于排序导入语句的样式。 您可以在以下选项之间进行选择:

  • gofmt :按字母顺序对每个现有导入组内的导入路径排序。

    gofmt 排序类型
  • goimports :按字母顺序对导入路径排序。 将包含句点的路径放入单独的组,并将以 appengine 开头的路径放入另一个组。 以下选项可以为 Go SDK 和本地软件包添加组。

    goimports 类型排序
  • 无 :不对 import 语句进行排序。

    无排序类型

将所有 import 移至一个声明中

将非 C 导入合并到一个 import 声明中并排序。

已禁用

已启用

将所有导入移到一个声明中
将所有导入移到一个声明中

将 Go SDK 中的软件包分组

将来自 Go SDK 软件包的导入放入单独的组中。 例如,来自 fmt 和 错误 的导入会归为一组。

已禁用

已启用

启用了 Go SDK 的组包
Go SDK 中的组包已被禁用

当空行分隔导入时,格式化程序会将导入保留在单独的组中。 若要将所有组中的 Go SDK 导入放在一起,请选择 将所有软件包移至一个组中。

将所有软件包移至一个组中

组

选择 组 以为本地导入创建单独的组。 然后选择以下选项之一:

  • 当前项目包 :为属于当前项目的软件包创建单独的组。

  • 以开始的导入 :为其路径以逗号分隔的前缀之一开头的导入创建单独的组。

    以开始的导入

其他

条目

描述

在注释前添加一个空格

在行注释中的 // 后添加一个 Space。

已禁用

已启用

在注释前添加一个空格
在注释前添加一个空格

要排除以特定前缀开头的注释,请点击 添加 图标("添加"图标 ),输入前缀,然后点击 OK。

排除以特定前缀开头的注释

填充段落"的列宽度

设置 填充段落 操作在 Go 注释中使用的最大行宽。 当缩进和编辑器右边距留下的 Space 较少时,该操作会使用较小的宽度。 默认值为80个字符。

之前

之后

填充段落"的列宽度
填充段落"的列宽度

在执行重新格式化代码操作时。

调用 重新格式化代码 后运行 gofmt。 此选项需要已配置且包含 gofmt 的 Go SDK。 此选项默认已启用。

2026年 11月 3日