在 GoLand 里快速格式化代码并统一团队的编码风格，是日常开发中一个特别能提升幸福感的小细节。你不需要每次保存都盯着缩进对不对、import 有没有多余、注释前有没有空格。只要把配置做对，按下 Ctrl+S 或 Cmd+S 的瞬间，代码就自动变得规规矩矩。

用快捷键一键格式化当前文件

这是最轻量、也最即时的方法。当你遇到某一段代码看着不顺眼，或者想快速验证格式效果时，按一下快捷键就好。

光标放到编辑区任意位置，按下 Ctrl+Alt+L（Windows/Linux）或 Cmd+Option+L（Mac），代码立即按照当前 Go 代码风格设置重排。

需要留意的是：

• 这个操作只作用在当前打开的文件，不会动其他未打开的文件。
• 它不会自动优化 import，除非你在设置里已经开启了“Optimize imports on the fly”。

保存时自动格式化 + 自动整理 import

这才是真正解放双手的配置，尤其适合新项目和协作环境。它让“保存即规范”成为默认动作，不用记快捷键，也不会漏掉。

第一步：确认 goimports 已安装

在终端执行 go install golang.org/x/tools/cmd/goimports@latest。装完后用 which goimports 查看路径（比如 /Users/xxx/go/bin/goimports），记下来。

第二步：配置 GoLand 使用 goimports

打开 Settings → Languages & Frameworks → Go → Formatting。

勾选 Run goimports。

点击右侧的 按钮，手动指定刚才查到的路径。

第三步：设置保存时触发

进入 Settings → Appearance & Behavior → System Settings → Actions on Save。

勾选 Reformat code 和 Optimize imports。

搞定这三步后，每次保存文件，GoLand 会自动调用 goimports：

• 删除未使用的包
• 按标准库/第三方/本地分组排序 import
• 格式化整段代码
• 严格遵循你定义的缩进与空格规则

自定义代码风格模板

快捷键和保存触发都依赖你设定的“样式模板”。如果团队有统一规范，必须在这里统一配置，否则每个人格式化出来的结果可能不一样。

设置缩进与制表符

打开 Settings → Editor → Code Style → Go，切换到 Spaces 标签页。

• 取消勾选 Use tab character
• 把 Tab size、Indent、Continuation indent 全部设为 4

设置右边距

切换到 Wrapping and Braces 标签页。

• 勾选 Ensure right margin is not exceeded
• 把 Right margin (columns) 设为 120

设置 import 排序

切换到 Imports 标签页。

• 勾选 Sort imported packages by name 和 Group imports
• 在 Import layout 里选择 Standard library, third-party, project 这种分组方式

【重要提醒】 改完任何一个标签页后，一定要点右下角的 Apply，再点 OK，否则设置不会生效。

临时跳过某段代码的格式化

方法一：用格式化开关注释

在不想被格式化的代码块开头插入 // @formatter:off，结尾插入 // @formatter:on。GoLand 会完全跳过这两行之间的所有内容，包括缩进、空行、import 等。

方法二：用特殊注释前缀规避空格干扰

某些 Go 库（比如 easyjson、sqlc）依赖不带空格的注释指令（如 //easyjson:json）。如果格式化后自动变成了 // easyjson:json，编译就会失败。

这时需要进入 Settings → Editor → Code Style → Go → Other，取消勾选 Add space before comment。

在下方的 Space before comment except for prefixes 中添加 easyjson、sqlc 这些前缀。

这一步如果不做，生成的结构体注解可能失效，后续的代码生成工具就会报错。