go version能运行不代表环境正常，必须验证完整链路：which/where go确认调用版本、go env goroot检查src/pkg目录存在、go build暴露链接问题、pprof需显式绑定0.0.0.0并curl验证、expvar需手动挂载、go mod init后须确保go111module=on且go list -m返回模块名。
go version 能跑，不代表运行时就正常
很多用户看到 go version 输出了版本号就以为万事大吉，但实际编译、链接、执行环节可能全卡在半路。比如 GOROOT 指向错误路径时，go version 仍能工作（它只读自身二进制），但 go run main.go 会直接报 cannot find package "fmt"——因为标准库根本没加载进来。
验证必须走完整链路：命令识别 → 环境变量合理 → 编译器可解析源码 → 链接器能找到符号 → 运行时能启动 Goroutine。
- 用
which go（macOS/Linux）或where go（Windows）确认调用的是你刚装的那版，不是旧残留 - 运行
go env GOROOT，输出路径下必须存在src和pkg目录，否则标准库缺失 - 别跳过
go build -o test .这步——go run是临时编译+执行，而go build才真正触发链接器，暴露 CGO 或平台兼容性问题
localhost:6060/debug/pprof/ 返回 HTML 就算 pprof 启动成功
pprof 不是“配置完就能看”，它依赖 HTTP 服务显式注册且端口可达。常见失败是代码里写了 http.ListenAndServe(":6060", nil)，结果服务只监听 127.0.0.1:6060（Go 1.19+ 默认行为），导致容器内或远程调试时 go tool pprof 连不上。
要让它真正可用，得明确绑定地址：
go
import _ "net/http/pprof"
func main() {
// 必须写成 "0.0.0.0:6060"，不能只写 ":6060"
http.ListenAndServe("0.0.0.0:6060", nil)
}
- 启动后立刻
curl http://localhost:6060/debug/pprof/，返回 HTML 列表才算就绪；返回空或 404 说明 handler 没挂上 -
/debug/pprof/goroutine?debug=2才能拿到全部协程堆栈（默认只返回 running 状态的） - 生产环境别把
0.0.0.0暴露到公网，哪怕加了防火墙——pprof 无认证机制，敏感信息（如内存布局、调用栈）直接裸奔
expvar.Handler() 要手动挂载，否则 /debug/vars 一定是 404
很多人以为导入 _ "net/http/pprof" 就自动有了 /debug/vars，其实不是。expvar 的 handler 是独立注册的，pprof 的导入只是顺带做了这件事，但不保证稳定——尤其用了 Gin、Echo 等框架时，中间件可能拦截 /debug/* 路由。
最稳妥的方式是显式挂载：
go
import "expvar"
import "net/http"
func main() {
http.HandleFunc("/debug/vars", expvar.Handler().ServeHTTP)
http.ListenAndServe("localhost:8080", nil)
}
- 挂载后
curl http://localhost:8080/debug/vars应返回 JSON，含cmdline、memstats、num_goroutine等字段 - 自定义指标只能用
expvar.Int、expvar.Float、expvar.String，往expvar.NewMap里塞 struct 或指针会 panic - 字段名拼错、没调用
expvar.Publish、或路由被中间件过滤，都会导致自定义指标不出现——别猜，先 curl 看原始响应
go mod init 成功 ≠ 模块系统真就绪
go mod init 静默生成 go.mod 文件，看起来很顺利，但背后可能埋着陷阱：如果当前目录在 $GOPATH/src 下且 GO111MODULE 是 auto（默认值），Go 会降级到 GOPATH 模式，go list -m 可能返回空或报错。
验证模块系统是否真正启用，必须组合两步：
- 执行
go env GO111MODULE，输出必须是on（不是auto） - 运行
go mod init example.com/test && go list -m，预期输出example.com/test；若输出command-line-arguments，说明模块未激活 - 再试
go get github.com/go-chi/chi/v5@latest，成功拉取并更新go.sum才算网络代理、模块缓存、校验机制全通
真正容易被忽略的是：GOROOT 损坏时，go mod 命令本身可能无法加载 vendor 或解析 go.mod 语法——它依赖标准库的 text/template 和 encoding/json，这些包一旦缺失，错误信息反而很模糊，比如 go: malformed module path。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
