GoLand 2026.3 Help

代码样式。 前往

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

制表符和缩进

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

项目

描述

使用制表符

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

智能制表符

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

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

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

选项卡大小

在此字段中,指定一个选项卡中包含的空格数。 默认值: 4。

缩进

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

续行缩进

指定延续前一行的行的缩进,使其清楚地成为同一语句或代码块的一部分。 当单个语句太长而无法放在一行时,会使用续行缩进。

默认值: 4。

保持空行的缩进

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

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

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

包装和大括号

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

项目

描述

在以下位置硬包装

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

输入时自动换行

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

  • 默认 :在这种情况下 GoLand 使用了在 全局设置中指定的 输入时自动换行 选项。

  • 是 :在这个例子中,GoLand 使用了在 在以下位置硬包装: 字段里指定的值。

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

视觉指南

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

函数调用实参

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

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

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

    请勿换行
  • 如果太长则进行换行 :选择此选项可以让超出右边界的行以正确的缩进进行折叠。

    如果太长则进行换行
  • 总是换行 :选择此选项可将列表中的所有元素设置为已包装,使每行一个元素并具有适当的缩进。

    总是换行
  • 如果太长就砍掉 :选择此选项可将列表中超出右边距的元素设置为已包装,使每行一个元素并具有适当的缩进。

    如果太长就砍掉

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

  • 将 '(' 后移到下一行 :在开头的括号后面添加新的一行。

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

复合字面量

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

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

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

    请勿换行
  • 如果太长则进行换行 :选择此选项可以让超出右边界的行以正确的缩进进行折叠。

    如果太长则进行换行
  • 总是换行 :选择此选项可将列表中的所有元素设置为已包装,使每行一个元素并具有适当的缩进。

    总是换行
  • 如果太长就砍掉 :选择此选项可将列表中超出右边距的元素设置为已包装,使每行一个元素并具有适当的缩进。

    如果太长就砍掉

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

  • 将 '(' 后移到下一行 :在开头的括号后面添加新的一行。

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

函数参数

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

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

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

    请勿换行
  • 如果太长则进行换行 :选择此选项可以让超出右边界的行以正确的缩进进行折叠。

    如果太长则进行换行
  • 总是换行 :选择此选项可将列表中的所有元素设置为已包装,使每行一个元素并具有适当的缩进。

    总是换行
  • 如果太长就砍掉 :选择此选项可将列表中超出右边距的元素设置为已包装,使每行一个元素并具有适当的缩进。

    如果太长就砍掉

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

  • 将 '(' 后移到下一行 :在开头的括号后面添加新的一行。

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

函数结果参数

选择函数结果参数的换行选项。 在 Go 中,结果参数显示在函数签名中的参数列表之后。 这些参数定义函数返回的值。

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

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

    请勿换行
  • 如果太长则进行换行 :选择此选项可以让超出右边界的行以正确的缩进进行折叠。

    如果太长则进行换行
  • 总是换行 :选择此选项可将列表中的所有元素设置为已包装,使每行一个元素并具有适当的缩进。

    总是换行
  • 如果太长就砍掉 :选择此选项可将列表中超出右边距的元素设置为已包装,使每行一个元素并具有适当的缩进。

    如果太长就砍掉

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

  • 将 '(' 后移到下一行 :在开头的括号后面添加新的一行。

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

导入

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

项目

描述

为 import 使用反引号

将双引号替换为反引号。

已启用

已禁用

go_use_backquotes_for_imports_cleared
为 import 使用反引号

为单个 import 添加括号

为单个 导入 声明添加圆括号。

删除多余的导入别名

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

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

排序类型

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

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

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

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

    无排序类型

将所有 import 移至一个声明中

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

已禁用

已启用

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

将 Go SDK 中的软件包分组

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

已禁用

已启用

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

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

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

组

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

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

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

    以开始的导入

其他

项目

描述

在注释前添加一个空格

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

已禁用

已启用

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

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

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

填充段落"的列宽度

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

之前

之后

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

在重新格式化代码操作时

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

2026年 11月 9日