GoLand中注释需分场景使用:Ctrl+/切换单行注释,Ctrl+Shift+/包裹多行注释,Ctrl+Alt+/(Win)或Ctrl+Cmd+/(macOS)在函数上方智能生成文档注释,文件头注释靠模板配置。

GoLand 里注释代码,不是靠“记住一堆快捷键”,而是分场景用对组合键——文件头、函数、单行、多行,各自有明确分工,混用反而容易出错。
单行和多行注释用 Ctrl+/ 和 Ctrl+Shift+/
这是最基础也最容易误操作的点:按一次 Ctrl+/ 是切换当前行是否注释(支持多选行),再按一次取消;Ctrl+Shift+/ 是包裹式多行注释,会在选中代码前后加 /* */。
- 如果光标在空行或只选中部分文本,
Ctrl+Shift+/可能生成不闭合的/*,手动补*/很麻烦 - Go 语言本身不鼓励
/* */多行注释(尤其在函数体内部),官方风格指南建议用连续的// - 批量注释时,优先用
Ctrl+/,它更符合 Go 的惯用法,且不会破坏结构体字段对齐
函数/方法上方自动插入文档注释用 Ctrl+Alt+/(Windows)或 Ctrl+Cmd+/(macOS)
这个快捷键触发的是 GoLand 内置的「Live Template」机制,不是简单插入固定文字,而是根据光标位置智能生成带参数占位符的注释块。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 必须把光标放在函数声明的正上方空白行,否则会报错或插到错误位置
- 默认模板只含
//开头的简单注释,如需// @param或// @return,得提前在File → Settings → Editor → Live Templates里配置 Go 模板 - 如果装了插件
Goanno,它会接管这个快捷键并提供更丰富的字段(比如自动提取参数名),但原生功能已够日常使用
新建 Go 文件时自动填充文件头注释
这和快捷键无关,是靠 File → Settings → Editor → File and Code Templates → Go File 配置的模板生效的。
- 模板里写
// @Author ${USER}这类变量,保存后新建.go文件就会自动渲染 - 注意
${DATE}默认格式是YYYY/MM/DD,如果项目要求2026-08-12,得改成${YEAR}-${MONTH}-${DAY} - 模板里别写
package main这类实际代码——它会和你后续输入冲突,只放注释即可
为什么 Ctrl+B 跳不到注释里的函数名?
因为 GoLand 的符号跳转(Ctrl+B)只识别代码语义,不解析注释内容。你在注释里写 // see func DoSomething(),IDE 不会把它当真实引用处理。
- 想让文档可跳转,得用 Go 原生支持的
func DoSomething()格式(不加//),但这样就不是注释了 - 真正可靠的跨文件引用,是用
godoc生成的 HTML 文档,或 VS Code + Go 扩展的悬停提示 - 别为了“看着像链接”而在注释里硬套函数名——维护成本高,且 IDE 不买账
注释这件事,核心矛盾不在快捷键记不记得住,而在于什么时候该用模板、什么时候该手写、什么时候干脆别注释。GoLand 的设计逻辑是:让机器管格式,让人管意图。

















