go 1.13起godoc已被官方彻底移除，因其维护成本高、模块整合差且存在安全风险；替代方案是内置go doc命令、golds工具或pkg.go.dev在线服务。
Go 1.13 起 godoc 已被官方移除，你现在无法用它启动本地文档服务或生成带导航的 HTML 站点；替代方案是内置的 go doc 命令，配合 golds（现代、模块感知）或直接导出静态 HTML。
为什么 godoc -http=:6060 不再工作
从 Go 1.13 开始，godoc 命令和 HTTP 服务功能被彻底移除。不是“找不到命令”，而是源码中已删除 —— 即使你尝试 go install golang.org/x/tools/cmd/godoc@latest，也会构建失败，因为该模块已被归档且不再维护。
常见错误现象包括：
command not found: godoc- 旧脚本里执行
godoc -http=:6060直接报错或静默退出 - 即使从旧 Go 版本复制二进制，也无法识别
replace或go.work中的路径，返回no package found
go doc 是当前最可靠的标准命令行方案
它随 Go 安装自带、模块感知、无需额外依赖，适用于绝大多数查阅场景。
- 查包文档：
go doc fmt、go doc net/http - 查函数或类型：
go doc time.Now、go doc io.Reader、go doc json.Marshal - 查看全部导出项（含私有字段说明）：
go doc -all encoding/json - 导出为 HTML 单页：
go doc -html fmt > fmt.html（注意：无搜索、无跳转、不支持多包导航） - 若提示
no documentation for package，检查是否在 module 根目录下运行，且go.mod存在
想生成可浏览的本地 HTML 文档？用 golds
它是目前兼容性最好、零配置、支持 Go 1.20+ 的替代工具，能正确处理 replace、go.work 和嵌套 module。
- 安装：
go install github.com/icholy/golds@latest - 生成静态文档：
golds -output ./docs .（递归扫描当前 module 所有包） - 启动本地服务：
golds -server -port 8080 -output ./docs，访问http://localhost:8080 - 注意：
golds不支持扫描$GOROOT/src（标准库文档请直接用pkg.go.dev）
注释写法直接影响 go doc 能否显示
文档提取只认紧贴导出符号（首字母大写）正上方、无空行、用 // 写的注释。格式错一点，整个包或函数就“消失”。
- 包注释必须写在
package xxx上方，且唯一；重复写多个文件会导致解析失败 - 首句必须是完整英文句子，以包名/函数名开头 + 空格 + 描述 + 英文句号，例如：
// Login handles user login request. - 不能用全角标点（如“。”）、不能小写开头、不能漏句号、不能中间插变量声明或空行
-
func和type注释前不能有任何东西 —— 连var cache = 1都会断开关联
真正容易被忽略的是：文档是否可见，不取决于你写了多少内容，而取决于那几行注释的位置、标点、大小写和空行——这些细节在 go doc 下极其敏感，但 IDE 悬停可能“宽容”地显示出来，造成误判。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
