godoc 命令自 Go 1.13 起被移除，官方推荐使用 Go 1.21+ 内置的 go doc -server 启动本地文档服务，默认端口 :6060，支持标准库及 GOPATH/GOMODCACHE 中已缓存的包。
godoc 命令在 Go 1.13+ 已被移除，别再找它了
Go 官方从 1.13 版本起正式弃用了 godoc 命令行工具和内置 HTTP 服务。你现在执行 godoc -http=:6060 会直接报错：command not found 或提示 “godoc is no longer included in Go”。这不是你装错了，是它真没了。
替代方案是用社区维护的 golang.org/x/tools/cmd/godoc（注意路径），但它仅支持到 Go 1.19，且对 Go 1.20+ 的模块文档解析有缺陷；更稳妥的路是转向 go doc CLI 或现代文档服务器。
用 go doc -server 启动轻量本地文档服务（推荐）
go doc -server 是 Go 1.21+ 内置的官方替代，不依赖外部包，启动快、兼容模块、支持搜索，端口默认 :6060，访问 http://localhost:6060 即可浏览本地所有已安装标准库 + GOPATH/GOPROXY 缓存的第三方包文档。
- 确保 Go 版本 ≥
1.21（运行go version确认） - 终端执行：
go doc -server（无需额外安装，不需GO111MODULE=off） - 如需换端口：加
-http=:8080参数，例如go doc -server -http=:8080 - 它只索引当前
GOPATH和$GOMODCACHE中已下载的包，没go get过的第三方库不会出现 - 不支持自定义静态页面或主题，纯官方风格，但足够清晰稳定
想看自己写的包文档？必须满足三个条件
本地包文档能被 go doc -server 扫描到，不是放对位置就行，得同时满足：
立即学习“go语言免费学习笔记（深入）”；
- 包路径在
GOROOT（标准库）、GOPATH/src（旧式工作区）或已通过go mod download缓存进$GOMODCACHE（模块模式下） - 包目录下有合法的
go.mod文件（模块模式必需），或位于GOPATH/src下且路径符合import路径规则（如GOPATH/src/github.com/user/pkg） - 源码中每个导出标识符（函数/类型/变量）前有紧邻的
//注释块，且注释里不能有空行（否则会被截断）
常见失败场景：go doc -server 启动后搜不到你的包名 → 检查 go list -m all | grep yourpkg 是否有输出；搜得到包但方法没文档 → 看注释是否被空行或结构体字段注释干扰了。
别碰 godoc 的 Docker 镜像或老版二进制编译
网上很多教程让你 go install golang.org/x/tools/cmd/godoc@latest 或拉 golang:1.12 镜像跑服务，这些在 Go 1.20+ 环境下大概率失败：
-
golang.org/x/tools/cmd/godoc在@master分支已归档，最新 tag 是v0.13.0（对应 Go 1.19），Go 1.21+ 编译会报undefined: errors.Is类错误 - Docker 镜像用旧 Go 版本，无法解析新模块的
go.sum格式，也读不到vendor外的本地开发包 - 即使硬编译成功，它仍用
GOROOT/src为根扫描，对go.work或多模块项目支持极差
除非你卡在 Go 1.18 且无法升级，否则所有绕过 go doc -server 的尝试，最终都会卡在路径识别或模块兼容上。
真正麻烦的从来不是启动命令，而是文档注释的格式细节和模块缓存路径是否被正确纳入索引 —— 这两点不调通，换十个工具都白搭。
