先运行 go test ./ 发现潜在兼容性问题，再用 go list -m -u all 定位可安全升级的依赖；间接依赖变更常致运行时 panic，需结合堆栈、changelog 和 replace 精准修复。
先跑 go test ./，再看 go list -m -u all，别急着 go get -u —— 大部分兼容性问题在测试失败前就藏在依赖版本差里。
go test ./ 报错但没提示具体包？说明是间接依赖行为变更
比如升级后 http.Client.Do 突然 panic，或 json.Unmarshal 对空 slice 处理逻辑变严格，这类问题不会直接报“版本冲突”，而是运行时崩。根本原因是某个间接依赖（比如 github.com/go-chi/chi）拉了新版 net/http 兼容层，而你的代码恰好踩中边界 case。
- 先执行
go test -v ./...，注意失败用例的堆栈最底层是否指向第三方包（如vendor/github.com/xxx/yyy） - 若堆栈含
panic: reflect.Value.Interface: cannot return value obtained from unexported field，大概率是某依赖升级后用了更激进的反射，需查它go.mod里golang.org/x/exp或github.com/google/gopacket类库的版本 - 临时加
-gcflags="all=-l" -ldflags="-s -w"编译再跑，能绕过部分内联导致的 panic 错误掩盖
go list -m -u all 显示一堆 [vX.Y.Z]，但 go mod tidy 不动它们？
go mod tidy 默认只满足“最小必要版本”，不会主动升到 [vX.Y.Z] 标出的新版——尤其当新版是主版本（如 v2.0.0）时，它会卡在旧版不动，除非你显式 go get。
- 执行
go list -m -u -f '{{if .Update}}{{.Path}} {{.Version}} → {{.Update.Version}}{{end}}' all，过滤出真正可安全升级的次/补丁版本（不含/v2这类路径） - 对关键依赖（如
golang.org/x/net,golang.org/x/crypto）单独go get golang.org/x/net@latest，避免go get -u ./一次性拉崩 - 如果
go list输出某包版本跳跃极大（如v0.0.0-20210220032951→v0.17.0），别直接上，先查它的 CHANGELOG 是否含 breaking change
replace 后 build 成功但 vendor 目录里还是旧版？
replace 只影响构建时解析，不改变 go mod vendor 的源——vendor 仍按 go.mod 原始 require 行拉取，除非你同时 require 了被 replace 的模块。
- 正确写法：在
go.mod中先加replace github.com/A/lib => github.com/A/lib v1.9.3，再执行go get github.com/A/lib@v1.9.3，这样require行才会更新 - 执行
go mod vendor前，先go mod verify确认go.sum无校验失败；否则 vendor 会静默跳过有问题的包 - 检查
vendor/modules.txt第三列（版本号）是否与go list -m github.com/A/lib输出一致，不一致说明 replace 未生效或被其他 replace 覆盖
CI 流水线里 go version 显示 1.25，但本地 go build 提示 requires go 1.24？
不是环境不一致，是 go.mod 第一行的 go 1.24 被 Git 拉取时换行符污染，或编辑器自动删了末尾空格导致解析失败——Go 工具链会把它当无效版本，降级 fallback 到 go env GOROOT 下的默认值。
- 用
xxd go.mod | head -n 5（Linux/macOS）或certutil -dump go.mod（Windows）看第三行是否为纯go 1.24，有 BOM 或 \r\n 就重写 - CI 镜像若用
golang:1.25-slim，确认它没被 Dockerfile 里的ENV GOROOT覆盖——Go 1.16+ 后GOROOT应为空，否则会强制锁定版本 - 本地执行
go env -w GO111MODULE=on，避免某些终端缓存旧值导致go mod命令失效
真正的坑不在命令怎么敲，而在你没意识到 go mod graph 输出里某条路径上的 // indirect 包，其实正悄悄把 encoding/json 的行为改得和标准库不一致。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
