# 代码样式。 Go

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

> **TL;DR**
> 按 `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)) 打开设置，然后转到  `编辑器 | 代码样式 | Go` 。
>
>
>
> 重格式化代码： `Ctrl+Alt+L` (Windows), `⌘ ⌥ L` (macOS), `⌘ ⌥ L` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ L` (macOS System Shortcuts), `Ctrl+Alt+L` (XWin), `Ctrl+Alt+L` (GNOME), `Alt+Shift+L` (KDE), `Ctrl+Alt+L` (Emacs), `Ctrl+Alt+L` (Sublime Text), `⌘ ⌥ L` (Sublime Text (macOS)), `Ctrl+Alt+Enter` (Visual Studio), `⌘ ⌥ ⏎` (Visual Studio (macOS)), `Alt+Shift+F` (NetBeans), `Ctrl+Alt+L` (Eclipse), `⌘ ⇧ F` (Eclipse (macOS))

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

## 制表符和缩进

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

|  条目  |  描述  |
| --- | --- |
|    使用制表符    |     使用 `Tab` (Windows), `⇥` (macOS), `⇥` (IntelliJ IDEA Classic (macOS)), `⇥` (macOS System Shortcuts), `Tab` (XWin), `Tab` (GNOME), `Tab` (KDE), `Tab` (Emacs), `Tab` (Sublime Text), `⇥` (Sublime Text (macOS)), `Tab` (Visual Studio), `⇥` (Visual Studio (macOS)), `Tab` (NetBeans), `Tab` (Eclipse), `⇥` (Eclipse (macOS)) 密钥进行缩进。 当复选框未勾选时， IntelliJ IDEA 使用空格而非制表符。 默认情况下，此复选框已选中。     |
|    智能制表符    |      * 如果选中此复选框，嵌套代码块的缩进将根据需要使用制表符和 Space，而对齐缩进将仅使用 Space。    * 如果此复选框未选中，将只使用选项卡。 这意味着一组符合指定制表符大小的空格将自动替换为一个制表符，这可能会导致精细对齐的破坏。        智能制表符   复选框在启用   使用制表符   选项时可用。 默认情况下，此复选框未选中。     |
|    选项卡大小    |  在此字段中，指定一个制表符包含的 Space 数。 默认值：  `4` 。  |
|    缩进    |  在此字段中，指定为每个缩进级别插入的空格数量。 默认值：  `4` 。  |
|    连续缩进    |     指定从上一行延续的行的缩进，以明确它们属于同一语句或代码块。 当单个语句过长而无法放在一行时，将使用连续缩进。       默认值：  `4` 。     |
|    保持空行的缩进    |     如果选中此复选框，IntelliJ IDEA 将会保持空行的缩进，就像它们包含了一些代码一样。       如果取消勾选此复选框，IntelliJ IDEA 将删除制表符和空格。       默认情况下，此复选框未选中。     |

## 换行和大括号

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

|  条目  |  描述  |
| --- | --- |
|    硬换行位置    |     使用   硬换行位置   字段指定元素右侧所需的边距空间。 如果您选择了   默认  选项，那么将使用 [全局设置](settings-code-style.html#rightMargin)中的右边距值。     |
|    在输入时换行    |     使用   在输入时换行   设置来指定如何将编辑的文本适应到指定的   硬换行位置   中：        * 默认 ：在这种情况下，IntelliJ IDEA 使用 在输入时换行 选项，该选项在 [全局设置](settings-code-style.html#wrapOnTyping) 中指定。    * 是 ：在这个例子中，IntelliJ IDEA 使用了在 右边距 字段里指定的值。    * 否 ：在这种情况下，此选项被关闭，一行可以超过右侧边距指定的值。    |
|    可视化参考线    |     使用   可视化参考线   字段来指定多个右边距。 您可以保留默认值，或者输入您的边距所需的空格数。 如果您想要指定多个边距，请输入由顿号分隔的数字。     |
|    函数调用实参    |     选择函数调用参数的换行选项。 在 Go 中，函数调用参数是在调用函数时传递给函数的值。       您可以在以下选项之间进行选择：        * 不换行 ：当选中此选项时，不会应用任何特定的换行样式，嵌套对齐和括号设置将被忽略。    * 过长时换行 ：选择此选项可以让超出右边界的行以正确的缩进进行折叠。    * 始终换行 ：选择此选项，可将列表中的所有元素设为已包装，使每行包含一个元素并具有适当的缩进。    * 过长时分行 ：选择此选项，可将列表中超出右边距的元素设为已包装，使每行包含一个元素并具有适当的缩进。      您可以将之前的选项应用于开启和关闭的括号：        * '(' 后换行 ：在开头的括号后面添加新的一行。    * 将“)”放在新的一行 ：在关闭括号前添加新行。    |
|    复合文字    |     选择复合字面量的换行选项。 在 Go 中，复合字面量是创建复合类型值的紧凑表示法，包括数组，切片，映射和结构体。       您可以在以下选项之间进行选择：        * 不换行 ：当选中此选项时，不会应用任何特定的换行样式，嵌套对齐和括号设置将被忽略。    * 过长时换行 ：选择此选项可以让超出右边界的行以正确的缩进进行折叠。    * 始终换行 ：选择此选项，可将列表中的所有元素设为已包装，使每行包含一个元素并具有适当的缩进。    * 过长时分行 ：选择此选项，可将列表中超出右边距的元素设为已包装，使每行包含一个元素并具有适当的缩进。      您可以将之前的选项应用于开启和关闭的括号：        * '(' 后换行 ：在开头的括号后面添加新的一行。    * 将“)”放在新的一行 ：在关闭括号前添加新行。    |
|    函数参数    |     选择函数参数的换行选项。 在 Go 中，函数参数是作为函数签名部分声明的变量，当函数被调用时，用于传递数据到函数。 将作为参数传递给函数的值赋予函数的参数，让函数可以操作数据。       您可以在以下选项之间进行选择：        * 不换行 ：当选中此选项时，不会应用任何特定的换行样式，嵌套对齐和括号设置将被忽略。    * 过长时换行 ：选择此选项可以让超出右边界的行以正确的缩进进行折叠。    * 始终换行 ：选择此选项，可将列表中的所有元素设为已包装，使每行包含一个元素并具有适当的缩进。    * 过长时分行 ：选择此选项，可将列表中超出右边距的元素设为已包装，使每行包含一个元素并具有适当的缩进。      您可以将之前的选项应用于开启和关闭的括号：        * '(' 后换行 ：在开头的括号后面添加新的一行。    * 将“)”放在新的一行 ：在关闭括号前添加新行。    |
|    函数结果参数    |     选择函数／方法结果形参的换行选项。 在 Go 中，结果形参位于函数／方法签名中的形参列表之后。 这些形参定义函数／方法返回的值。       您可以在以下选项之间进行选择：        * 不换行 ：当选中此选项时，不会应用任何特定的换行样式，嵌套对齐和括号设置将被忽略。    * 过长时换行 ：选择此选项可以让超出右边界的行以正确的缩进进行折叠。    * 始终换行 ：选择此选项，可将列表中的所有元素设为已包装，使每行包含一个元素并具有适当的缩进。    * 过长时分行 ：选择此选项，可将列表中超出右边距的元素设为已包装，使每行包含一个元素并具有适当的缩进。      您可以将之前的选项应用于开启和关闭的括号：        * '(' 后换行 ：在开头的括号后面添加新的一行。    * 将“)”放在新的一行 ：在关闭括号前添加新行。    |

## 导入

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

|  条目  |  描述  |
| --- | --- |
|    对 import 使用反引号    |     将双引号替换为反引号。      \|  已启用  \|  已禁用  \| \| --- \| --- \| \|    ![go_use_backquotes_for_imports_cleared](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_go_use_backquotes_for_imports_set.png)  \|    ![对 import 使用反引号](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_use_backquotes_for_imports_cleared.png)  \|    |
|    为单个 import 添加括号    |  在单个  `import`  声明周围添加圆括号。  |
|    删除多余的导入别名    |  当导入别名与软件包限定符匹配且不需要其他限定符时，将其移除。 例如，  `logrus`  别名会从以下导入条目中移除：    ```GO                     import ( 	logrus "github.com/sirupsen/logrus" )                  ```    |
|    排序类型    |     选择用于排序导入语句的样式。 您可以在以下选项之间进行选择：        * gofmt ：按字母顺序对每个现有导入组内的导入路径排序。 ![gofmt 排序类型](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_gofmt_sorting_type.png)    * goimports ：按字母顺序对导入路径排序。 将包含句点的路径放入单独的组，并将以 `appengine` 开头的路径放入另一个组。 以下选项可以为 Go SDK 和本地软件包添加组。 ![goimports 类型排序](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_goimports_sorting_type.png)    * 无 ：不对 `import` 语句进行排序。 ![无排序类型](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_none_sorting_type.png)    |
|    将所有 import 移至一个声明中    |     将非 C 导入合并到一个  `import`  声明中并排序。      \|  已禁用  \|  已启用  \| \| --- \| --- \| \|    ![将所有导入移到一个声明中](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_move_all_imports_in_a_single_declaration.png)  \|    ![将所有导入移到一个声明中](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_move_all_imports_in_a_single_declaration_disabled.png)  \|    |
|    将 Go SDK 中的软件包分组    |     将来自 Go SDK 软件包的导入放入单独的组中。 例如，来自  `fmt`  和  `错误`  的导入会归为一组。      \|  已禁用  \|  已启用  \| \| --- \| --- \| \|    ![启用了 Go SDK 的组包](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_group_packages_from_go_sdk_off.png)  \|    ![Go SDK 中的组包已被禁用](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_group_packages_from_go_sdk_on.png)  \|      当空行分隔导入时，格式化程序会将导入保留在单独的组中。 若要将所有组中的 Go SDK 导入放在一起，请选择   将所有软件包移至一个组中  。      ![将所有软件包移至一个组中](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_move_all_packages_to_a_single_group.png)  |
|    组    |     选择   组   以为本地导入创建单独的组。 然后选择以下选项之一：        * 当前项目包 ：为属于当前项目的软件包创建单独的组。    * 以开始的导入 ：为其路径以逗号分隔的前缀之一开头的导入创建单独的组。 ![以开始的导入](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_imports_starting_with.png)    |

## 其他

|  条目  |  描述  |
| --- | --- |
|    在注释前添加一个空格    |     在行注释中的  `//`  后添加一个 Space。      \|  已禁用  \|  已启用  \| \| --- \| --- \| \|    ![在注释前添加一个空格](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_add_a_leading_space_to_comments_off.png)  \|    ![在注释前添加一个空格](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_add_a_leading_space_to_comments_on.png)  \|      要排除以特定前缀开头的注释，请点击   添加   图标（ !["添加"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)），输入前缀，然后点击   OK  。      ![排除以特定前缀开头的注释](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_exclude_comments_that_start_with_a_certain_prefixes.png)  |
|    填充段落"的列宽度    |     设置   填充段落   操作在 Go 注释中使用的最大行宽。 当缩进和编辑器右边距留下的 Space 较少时，该操作会使用较小的宽度。 默认值为80个字符。      \|  之前  \|  之后  \| \| --- \| --- \| \|    ![填充段落"的列宽度](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_column_width_for_fill_paragraph_before.png)  \|    ![填充段落"的列宽度](https://resources.jetbrains.com.cn/help/img/idea/2026.3/go_column_width_for_fill_paragraph_after.png)  \|    |
|    在执行重新格式化代码操作时。    |  调用   重新格式化代码   后运行  `gofmt` 。 此选项需要已配置且包含  `gofmt`  的 Go SDK。 此选项默认已启用。  |

## See also

### 过程

[代码样式方案](configuring-code-style.html)

