GoLand 2025.2 Help

代码风格。 Go

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

制表符与缩进

配置缩进、TAB 和空格字符的代码风格。

使用此页面配置 SQL 文件的格式设置选项。 当您更改这些设置时, 预览 窗格将显示其对代码的影响。

项目

描述

使用制表符

使用 Tab 键进行缩进。 取消选中此复选框时,GoLand 使用空格代替制表符。 默认情况下,此复选框处于未选中状态。

智能制表符

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

  • 清除此复选框后,仅使用制表符。 这意味着与指定的制表符宽度相符的一组空格会自动替换为一个制表符,这可能会破坏精确的对齐方式。

启用 使用制表符 选项后,将提供 智能制表符 复选框。 默认情况下,此复选框处于未选中状态。

制表符大小

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

缩进

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

连续缩进

指定上一行继续的代码行的缩进,使其清楚地表明是同一语句或代码块的一部分。 当单个语句太长无法放入一行时,将使用续行缩进。

默认值: 8

空行时保持缩进

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

清除此复选框后,GoLand 将删除制表符和空格字符。

默认情况下,此复选框处于未选中状态。

换行和大括号

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

项目

描述

强制换行位置

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

键入时换行

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

  • 默认 :在此情况下,GoLand 使用 键入时换行 选项,该选项在 全局设置 中指定。

  • :在此情况下,GoLand 使用 在此处强制换行: 字段中指定的值。

  • :在此情况下,该选项被关闭,代码行可以超出右边距中指定的值。

视觉参考线

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

函数调用实参

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

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

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

    不换行
  • 过长时换行 :选择此选项可在超出右边距的代码行换行,并使用适当的缩进。

    过长时换行
  • 始终换行 :选择此选项可对列表中的所有元素换行,使每行一个元素,并使用适当的缩进。

    始终换行
  • 过长时拆分 :选择此选项可对超出右边距的列表元素换行,使每行一个元素,并使用适当的缩进。

    过长时拆分

您可以将上述选项应用于括号的开始和结束位置:

  • 在'(' 后换行 :在左括号后添加新行。

  • 将')' 置于新行中 :在右括号前添加新行。

复合字面量

选择复合字面量的换行选项。 在 Go 中,复合字面量是用于创建复合类型值的简洁表示方式,复合类型包括数组、切片、映射和结构体。

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

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

    不换行
  • 过长时换行 :选择此选项可在超出右边距的代码行换行,并使用适当的缩进。

    过长时换行
  • 始终换行 :选择此选项可对列表中的所有元素换行,使每行一个元素,并使用适当的缩进。

    始终换行
  • 过长时拆分 :选择此选项可对超出右边距的列表元素换行,使每行一个元素,并使用适当的缩进。

    过长时拆分

您可以将上述选项应用于括号的开始和结束位置:

  • 在'(' 后换行 :在左括号后添加新行。

  • 将')' 置于新行中 :在右括号前添加新行。

函数形参

选择函数参数的换行选项。 在 Go 中,函数参数是作为函数签名的一部分声明的变量,用来在调用函数时传递数据。 传递给函数的参数值将被赋值给函数的参数,使函数能够处理这些数据。

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

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

    不换行
  • 过长时换行 :选择此选项可在超出右边距的代码行换行,并使用适当的缩进。

    过长时换行
  • 始终换行 :选择此选项可对列表中的所有元素换行,使每行一个元素,并使用适当的缩进。

    始终换行
  • 过长时拆分 :选择此选项可对超出右边距的列表元素换行,使每行一个元素,并使用适当的缩进。

    过长时拆分

您可以将上述选项应用于括号的开始和结束位置:

  • 在'(' 后换行 :在左括号后添加新行。

  • 将')' 置于新行中 :在右括号前添加新行。

函数结果形参

选择函数参数的换行选项。 在 Go 中,函数可以有一个或多个结果参数,这些参数在参数列表之后声明,用于将值从函数返回给调用方。 结果参数是通过函数的返回类型指定的。

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

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

    不换行
  • 过长时换行 :选择此选项可在超出右边距的代码行换行,并使用适当的缩进。

    过长时换行
  • 始终换行 :选择此选项可对列表中的所有元素换行,使每行一个元素,并使用适当的缩进。

    始终换行
  • 过长时拆分 :选择此选项可对超出右边距的列表元素换行,使每行一个元素,并使用适当的缩进。

    过长时拆分

您可以将上述选项应用于括号的开始和结束位置:

  • 在'(' 后换行 :在左括号后添加新行。

  • 将')' 置于新行中 :在右括号前添加新行。

导入

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

说明

为import 使用反引号

将双引号替换为反引号。

启用

禁用

go_use_backquotes_for_imports_cleared
为导入使用反引号

为单个导入添加括号

即使 import 部分只有一个 import 语句,也添加括号。

移除冗余导入别名

当别名与依赖项名称相同时,移除该别名。 例如,将从以下导入条目中移除 logrus 别名:

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

排序类型

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

  • gofmt :以字母顺序对 import 语句进行排序。 标准库包与第三方包混合排序。

    gofmt 排序类型
  • goimports :按特定顺序对 import 语句进行排序,优先放置标准库包,然后是第三方包,最后是本地包。

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

    无排序类型

将所有import 移至一个声明中

将所有 import 语句分组为文件顶部的一个代码块。

已禁用

已启用

在单个声明中移动所有导入
在单个声明中移动所有导入

将Go SDK 中的软件包分组

将属于 Go SDK 包的 import 语句归为一组。 例如,来自 fmterrors 等包的 import 语句将被归为一组。

已禁用

已启用

启用从 Go SDK 分组软件包
禁用从 Go SDK 分组软件包

请注意,如果 import 语句之间被其他包的语句分隔,则此设置不会将其合并。 要将所有 import 语句归为一个部分,请选择 将所有软件包移至一个组中

将所有软件包移动到一个分组中

分组

根据所选选项对 import 语句进行分组。 您可以选择以下选项:

  • 当前项目软件包 :将属于当前项目的包分组。 这意味着该设置会将当前项目的包与任何外部库的包(Go SDK、 go.mod 文件中的库、 vendor 目录中的文件等)分开。

  • 导入开头 :将以某个前缀开头的包分组。 您可以用逗号分隔列出所有前缀。 所有对应的包将被移至一个分组内。

    以以下内容开头的导入

其他

项目

描述

向注释添加前导空格

在双斜杠与注释文本之间添加空格。

已禁用

已启用

为注释添加前导空格
为注释添加前导空格

要排除以某些前缀开头的注释,请单击 添加 图标(添加图标 ),输入前缀,然后单击 确定

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

填充段落的列宽

指定注释中在换行前允许的最大字符数。 该限制适用于注释文本,并重新分配行、空格和换行符,以使各行在限制范围内显示。 默认值为 80 个字符。

之前

之后

填充段落的列宽
填充段落的列宽

执行“重新设置代码格式”操作时(R)

在代码重新格式化时自动运行 gofmt。 默认情况下,重新格式化代码请按 Ctrl+Alt+L

最后修改日期: 2025年 9月 26日