最直接查函数签名用go doc os.readfile，立刻显示定义、参数、返回值及注意事项；必须用点号连接包名和函数名，大小写敏感，pkg.go.dev支持版本切换与错误类型展开。
go doc 命令查函数签名最直接
终端里敲 go doc os.ReadFile，立刻看到函数定义、参数类型、返回值、错误说明和注意事项——比搜网页快，还不怕链接失效。它不依赖网络，也不需要开浏览器，源码注释写在哪，它就从哪读。
常见误区是把包名和函数名分开输，比如 go doc os readfile（错），必须用点号连接：go doc os.ReadFile。大小写敏感，Readfile 会报 “no symbol”。
-
go doc fmt.Printf查格式化输出函数 -
go doc time.Time.Add查结构体方法（注意是点号，不是冒号或空格） -
go doc net/http.Client.Do查带接收者的方法，别漏掉Client类型
pkg.go.dev 是唯一能看版本差异的在线文档
https://pkg.go.dev/ 不只是“网页版 godoc”，它的核心价值在于：版本切换按钮真实可用。比如你项目还在用 Go 1.19，而同事提了 PR 用了 os.ReadFile，你点开页面右上角的版本下拉菜单，选 1.19 就能看到这个函数压根不存在——它从 1.16 才引入，1.15 及以前只能用 ioutil.ReadFile（已废弃）。
另一个关键点是错误类型提示。比如查 os.Open，页面里明确列出它可能返回 *os.PathError，而这个类型有 Err 字段可进一步判断是否为 syscall.ENOENT。这种链路式错误处理信息，在终端 go doc 里往往被折叠，但在 pkg.go.dev 上点开类型就能展开看。
查方法时必须分清包级函数和类型方法
看到 http.Get 调用，别急着去查 net/http.Get——先确认它是包级函数还是某个类型的实例方法。实际文档里会有两个 Get：一个是 func Get(url string) (...)（无接收者），另一个是 func (c *Client) Get(url string) (...)（带 (c *Client) 接收者）。
调用方式决定查哪个：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
http.Get(...)→ 查无接收者的那个，属于包级函数 -
client := &http.Client{}; client.Get(...)→ 查带(c *Client)的那个，是*Client类型的方法 - 混淆后果：按方法签名去传参却用了包级调用，编译器直接报
undefined: http.Client.Get
自定义包和第三方包的文档怎么查
本地模块里的包，确保你在 go.mod 所在目录下运行命令：go doc myutil（包名要小写，且包内有 // Package myutil 注释）。如果提示 “no package found”，大概率是没写包注释，或不在模块根路径。
第三方包如 github.com/spf13/cobra，需先 go install github.com/spf13/cobra@latest，再用 go doc -u cobra。注意 -u 参数不可少，否则默认只查标准库。
容易被忽略的是注释格式：函数前不能有空行，注释首行必须和函数名完全一致，否则 go doc 读不到。例如：
// ParseFlags 解析命令行标志
func ParseFlags() { ... }
写成 // 解析命令行标志 或加空行，go doc mypkg.ParseFlags 就会返回 “no documentation found”。
真正卡住人的往往不是找不到函数，而是查到了却用错上下文：比如把 bufio.Scanner 当作通用流读取器，结果大文件扫到一半 panic —— 因为默认缓冲区只有 64KB，超长行直接失败。查文档时得连带看 “See also” 和 “Examples” 栏，而不是只盯签名那一行。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
