goland函数注释必须用live templates配置，因其无内置自动注释开关；需设abbreviation（如fn），模板含$description$等变量，但不支持自动提取函数信息，依赖手动输入或goanno插件补充。
GoLand 函数注释模板必须用 Live Templates 配置
GoLand 本身不提供“函数上方自动加说明”的内置开关，所有自动生成的函数注释都依赖 Live Templates。你不能靠改 File Templates 或插件设置来实现这个效果——那些只管文件头或结构体/接口，不管函数体前的注释。
常见错误是试图在 File and Code Templates → Go File 里写函数注释模板，结果新建文件时多出一堆空注释，或者根本不出现在函数上方。
- 打开
Settings → Editor → Live Templates - 点击
+→Live Template -
Abbreviation填一个短触发词，比如fn（别用func，它已被 Go 内置模板占用） -
Template text填入：// $DESCRIPTION$ func $FUNCTION_NAME$($PARAMS$) $RETURN_TYPE$ { $END$ } - 点击
Define，勾选Go
变量 $DESCRIPTION$ 必须手动赋值或留空
GoLand 的 Live Templates 不支持自动提取函数名、参数或返回值生成描述文本——${function_name} 这类占位符只在 Goanno 插件里有效，在原生 Live Templates 中无效。所以 $DESCRIPTION$ 实际上只能是固定文案、空行，或靠你敲完函数后手动补。
如果你希望每次触发都弹出输入框填描述，就双击 $DESCRIPTION$ → 点击 Edit variables → 在 Expression 栏留空 → 勾选 Skip if defined。这样每次用 fn + Tab，光标会先停在描述位置，你输完再按 Tab 跳到函数名。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 不要指望
date()或time()自动插入时间戳——它们在 Live Templates 变量中不可用，除非你装了第三方插件 - 若想省事，直接把
$DESCRIPTION$设为// TODO:，后续再补全 - 避免用中文冒号（：）或全角空格，否则 Tab 行为可能异常
快捷键触发比鼠标点更可靠
配置完模板后，别去菜单里找“插入模板”，那样容易选错上下文。最稳的方式是在函数声明前的空行，直接输入你设的 abbreviation（如 fn），然后按 Tab。
如果没反应，检查三点：是否只勾选了 Go（没勾 Everywhere）；当前光标是否在合法的 Go 代码区域（比如不在字符串或注释里）；有没有被其他插件的快捷键拦截（比如 Goanno 的 Ctrl+Alt+/ 会抢焦点）。
- 触发失败时，右下角状态栏会显示 “No applicable templates” —— 这说明上下文不匹配，不是模板没生效
- 想快速测试，新建一个
.go文件，输入fn+Tab，看是否生成带空行注释的函数骨架 - 不要把 abbreviation 设成单字母（如
f），容易和 Go 关键字func冲突导致误触发
Goanno 插件能自动填充但依赖光标位置
如果你真要“一键生成含函数名、参数、返回值的完整注释”，Goanno 是目前最接近需求的方案，但它不走 Live Templates 流程，而是绑定快捷键（默认 Ctrl+Alt+/），且要求光标必须严格落在函数签名第一行的开头（即 func 左侧）。
常见失效场景：光标在函数名中间、在括号内、在换行后缩进处——这时 Goanno 会静默失败，不报错也不生成。
- 安装后必须重启 GoLand，否则快捷键不注册
- 模板里写的
${function_name}实际取的是光标所在行第一个识别出的函数名，不是你刚敲的那行——所以建议写完函数签名再按快捷键 - 如果函数有泛型参数或复杂返回类型（如
(err error, data map[string]interface{})），Goanno 可能解析错误，生成的@Param或@Return为空或错乱
