goland 不支持保存时自动为新增函数补全文档，但可通过 live template（go:func）、file watchers 配合脚本或插件 godoc assistant 实现手动/半自动生成功能，推荐使用快捷键触发以确保注释准确性。
GoLand 本身不支持“保存时自动为新增函数补全文档”这一行为——它不会主动扫描新写的函数并插入 // 注释块或 godoc 格式文档。但你可以通过组合配置 + 快捷键 + 插件，实现「写完函数后一键生成标准文档注释」，且能绑定到保存动作上。
启用 GoDoc 注释模板并手动触发
GoLand 内置了 go:func Live Template，可快速生成符合 godoc 规范的函数注释：
- 在函数签名上方空行处输入
go:func，按Tab即可展开为带参数、返回值占位符的注释块 - 该模板默认启用，路径为：
Settings | Editor | Live Templates | Go - 若未生效，检查是否勾选了
Expand with Tab，且作用域设为Go
用 File Watchers 实现“保存即补全”（需配合外部工具）
纯 IDE 无法自动识别“新增函数”，但可通过 golines 或自定义脚本 + File Watchers 在保存时运行文档生成逻辑：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 先安装支持 doc 注释生成的 CLI 工具，例如
go install github.com/icholy/godoc2md@latest（仅转换）或更实用的go install mvdan.cc/gofumpt@latest（格式化时保留/补全基础注释） - 更推荐：用
golint配合自定义 shell 脚本，在保存.go文件时扫描新增函数并插入//行（需自行编写正则匹配func [a-zA-Z0-9_]+\(.*\)后无注释的情况） - 在
Settings | Tools | File Watchers中新建 watcher，设置Program为你的脚本，Arguments传入$FilePath$，Working directory设为$ProjectFileDir$ - ⚠️ 注意：此方式无法精准判断“是否为新增函数”，容易重复添加或覆盖已有注释，需谨慎测试边界 case
用插件替代：GoDoc Assistant（第三方）
社区插件 GoDoc Assistant 提供了更贴近需求的功能：
- 安装后，右键函数名 →
Generate GoDoc comment，自动提取参数名、类型和返回值，生成标准注释 - 支持快捷键绑定（如
Alt+D），可进一步在Settings | Keymap中将其映射到Save Document动作（但不推荐直接覆盖保存行为，易误触发） - 插件不会在保存时静默执行，而是显式触发，避免污染已有注释或干扰编辑节奏
- 注意：该插件不维护
go.mod依赖，需确认其兼容 GoLand 2026.x 版本（当前最新版已适配）
真正稳定可用的方式，是接受「写完函数后按一次快捷键生成文档」这个动作，而不是追求全自动。因为函数语义、参数含义、副作用说明等，必须由人判断——IDE 只能搭骨架，填内容还得靠你。强行自动化反而容易产出空泛、错误甚至误导性的注释。
