go doc查不到函数因未指定完整包路径，如需查http.handlefunc应运行go doc net/http.handlefunc；查命令行工具需加-cmd参数，如go doc -cmd gofmt；显示内容少需确保在模块根目录并用-src查看源码片段。
go doc 命令查不到函数？先确认包路径和符号名是否匹配
标准库里很多函数不在顶层包下，比如 http.HandleFunc 实际属于 net/http 包，但你输 go doc HandleFunc 会失败——因为没指定包。Go 的 go doc 默认只查当前目录的包，不自动推导标准库路径。
实操建议：
- 查标准库函数必须带完整包路径：
go doc net/http.HandleFunc - 查包整体文档用
go doc net/http，会列出所有导出类型、函数、变量 - 查某个类型的方法（如
bytes.Buffer）：用go doc bytes.Buffer，不是go doc Buffer - 如果提示
no such package，可能是 GOPATH 或 Go 版本太老，但更大概率是包名拼错（比如把strings写成string）
go doc -cmd 查不到命令行工具说明？因为默认不显示 main 包
go doc 默认忽略 main 包，而像 go、gofmt 这类命令行工具的源码都在 cmd/xxx 下，属于 main 包，所以直接 go doc cmd/gofmt 也没用。
实操建议：
- 加
-cmd参数才能查命令行工具：go doc -cmd gofmt - 注意这里不用写
cmd/gofmt，go doc -cmd会自动在cmd/下找 - 查
go命令本身用go doc -cmd go，不是go doc cmd/go - 该参数只对标准库里的
cmd/子目录有效，自定义的main包仍不可查
为什么 go doc 显示内容少得可怜？可能你漏了 -src 或没进对目录
go doc 默认只显示导出项的签名和注释，不展示源码或内部实现。但有时连注释都空，常见原因是：当前目录不在模块根路径下，或者没用 go mod init 初始化过。
实操建议：
- 确保在模块根目录（含
go.mod文件）下运行go doc，否则它可能退化为 GOPATH 模式，行为不稳定 - 想看源码片段（比如函数体前几行），加
-src参数：go doc -src fmt.Println -
-src不会显示完整源文件，只截取定义处上下文，适合快速确认参数顺序或接收者类型 - 某些函数（如内建函数
len、cap）无法用go doc查，它们没有 Go 源码，得查语言规范或go help builtins
go doc 启动本地服务器后打不开？端口被占或没开浏览器
go doc -http=:6060 启动的是纯 HTTP 服务，不自动打开浏览器，也不处理端口冲突——如果 6060 已被占用，它就直接报错退出，不会换端口。
实操建议：
- 启动前先检查端口：
lsof -i :6060（macOS/Linux）或netstat -ano | findstr :6060（Windows） - 换端口更稳妥：
go doc -http=:6061，然后手动访问http://localhost:6061 - 服务只响应本地请求（绑定
127.0.0.1），不能通过局域网 IP 访问 - 关闭服务只需 Ctrl+C，进程不会后台残留
真正容易卡住的地方是包路径拼写和当前工作目录——不是命令不会用，而是它严格依赖 Go 模块路径解析逻辑。多试一次 go list std 看标准库包名全表，比反复猜更省时间。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
