godoc需手动安装且配置严格：go 1.13+移出标准工具链，须执行go install golang.org/x/tools/cmd/godoc@latest，启用go111module=on、配置goproxy，确保$gobin在$path；启动时用-goroot=.包含本地模块，注释须紧贴导出标识符。
装不上 godoc 就别想启动本地文档服务——Go 1.13 起它已彻底移出标准工具链，不手动安装就只能看到 command not found。
godoc 命令不存在？先确认安装方式是否正确
老教程里用 go get 安装是错的，Go 1.17+ 已弃用该命令；go install golang.org/x/tools/cmd/godoc@latest 才是唯一有效路径。
- 必须启用 modules：
go env -w GO111MODULE=on - 国内用户必配代理，否则卡在下载依赖：
go env -w GOPROXY="https://goproxy.cn,direct" - 安装后二进制默认落在
$GOBIN（通常是$GOPATH/bin），确保该路径已加入$PATH，否则终端找不到命令 - 验证是否装好：
godoc -version应输出版本号，不是报错
godoc -http=:6060 启动失败？检查端口与根路径
godoc -http=:6060 默认只扫描 $GOROOT/src 和 $GOPATH/src，你的项目不在其中就压根不会出现。
- 若项目是 Go Module（有
go.mod），加-goroot=.显式指定当前目录：godoc -http=:6060 -goroot=. - 端口被占常见于 macOS（6060 常被 Docker 或其他工具占用），换一个试试：
godoc -http=:8080 - 没有“自动刷新”或“监听文件变化”功能——改完注释只需刷新网页，不用重启服务
- 别信网上说的
-sync_minutes或配置文件，godoc不支持这些参数，纯属过时资料误导
注释写了却看不到？位置和导出规则决定一切
godoc 不是搜索引擎，它靠语法位置硬匹配：注释必须紧贴声明，中间不能空行，且标识符必须导出（首字母大写）。
- 包注释：必须在
package xxx上一行，多文件包中按文件名排序合并所有包注释 - 函数/类型注释：必须紧贴
func/type声明上一行，空一行就断开关联 - 私有标识符（如
func helper()）再详细注释也绝不会出现在文档中 - 想让常量/变量显示注释，所有同组成员都得加注释，漏一个可能导致整组不显示
替代方案：go doc -http 是更现代的选择（Go 1.21+）
如果你用的是 Go 1.21 或更新版本，go doc -http=:6060 是内置命令，无需额外安装，但行为不同：
- 它只服务标准库 + 已安装模块（
go install过的包），不扫描本地未go mod init的裸目录 - 不支持
-goroot参数，想看自己项目还得走传统godoc流程 - 启动更快、内存占用更低，适合只查标准库或常用第三方包的场景
真正容易被忽略的是：godoc 对目录结构极其敏感，哪怕 go.mod 在子目录里，-goroot=. 也必须在模块根目录下执行——进错一层，整个项目就消失在文档列表里。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
