go doc查不到包文档主因是路径或模块配置错误：需在含go.mod的模块根目录运行，GOPATH模式下要设GO111MODULE=off；注释须紧贴声明且格式规范，首句为完整句子；弃用godoc，改用go doc或pkg.go.dev。
go doc 命令查不到包文档？先确认 GOPATH 和模块路径
本地包没被 go doc 识别，大概率不是命令用错了，而是 Go 没找到你的包。Go 1.11+ 默认启用 module 模式，go doc 只认当前模块根目录（含 go.mod）下的包，或已安装的第三方模块。
- 确保你在包所在模块的根目录下运行命令，例如：
go doc mypkg要求当前路径下有go.mod，且mypkg是该模块内子目录 - 如果包在
$GOPATH/src下（非 module 模式），需确保GO111MODULE=off，否则会被忽略 - 跨模块引用时，
go doc不支持直接查未go get的本地路径包；得先go install或用go doc -u查已缓存版本
godoc 已废弃，改用 go doc 或 pkg.go.dev
Go 官方早在 1.13 就弃用了独立的 godoc 命令和本地服务。现在标准做法是：
-
go doc：查本地模块或已下载依赖的文档，支持函数、类型、方法，例如：go doc fmt.Printf、go doc time.Now -
go doc -all：显示包中所有导出项（含未加注释的），适合快速扫视结构 - 在线查最新稳定版文档，直接访问 pkg.go.dev，它自动索引公开模块，支持搜索、版本切换、示例渲染
- 注意：
pkg.go.dev只收录已发布到公共代理（如 proxy.golang.org）的模块，私有仓库需自行部署类似服务或用go doc本地查
注释写法直接影响生成效果：必须是紧贴声明的块注释
Go 不解析任意注释，只有满足特定格式的注释才会被提取为文档：
Browse website - Crawls sites automatically and mounts pages as markdown files you can grep, diff, cat, and explore with standard Unix commands — over SSH or HTTP
下载
将任意网站转换为文件系统，自动抓取网站并将页面挂载为 Markdown 文件，可使用 grep、diff、cat 等标准 Unix 命令进行搜索、比较、读取和浏览。
- 包级文档：放在
package xxx上方，且**前面不能有空行**，例如：// Package myutil provides helpers for string and time. // It's designed for internal use only. package myutil
- 函数/类型文档：必须是紧邻声明的
//块，中间不能插入空行或其它语句；多行用连续//，不要用/* */ - 首句应为完整句子（以大写字母开头、句号结尾），这是
go doc摘要显示的内容 - 避免在注释里写代码示例——
pkg.go.dev支持从ExampleXXX函数自动提取，但普通注释中的代码块不会被渲染
生成静态 HTML 文档？别折腾 godoc server，用 genmd 或 docgen
Go 官方不提供生成静态 HTML 文档的工具，go doc -html 在新版本中已被移除。真需要离线 HTML，推荐轻量方案：
立即学习“go语言免费学习笔记（深入）”；
-
genmd（GitHub 上的开源工具）：把 Go 注释转成 Markdown，再用 Hugo / MkDocs 渲染，适合集成进 CI 生成项目文档站 -
docgen：更简单，直接输出单页 HTML，但只支持基础结构，无搜索/导航 - 自己写脚本调用
go list -json+go doc -json提取元数据，再模板渲染——适合有定制需求的团队 - 重要提醒：任何静态生成都绕不开「注释质量」。如果函数没注释、参数没说明、返回值没解释，生成出来就是一堆空架子
文档能不能被人看懂，80% 取决于你写注释时有没有把自己当成第一次接触这个函数的人。别省那几行字，尤其是错误返回值的含义和边界条件。
