ambiguous import错误源于同一导入路径在多个模块中被声明，如github.com/ugorji/go v1.1.4与github.com/ugorji/go/codec v1.2.9冲突；需通过go list、go mod graph定位来源，统一require主模块版本并用replace强制归一，再执行go mod tidy清理冗余声明。
直接结论：这不是环境没搭好，而是模块路径解析时发现同一个包被多个 go.mod 声明了不同路径或版本，Go 编译器拒绝模糊选择。
为什么会出现 ambiguous import 错误
Go 不允许同一个导入路径（如 github.com/ugorji/go/codec）在多个模块中同时存在。常见诱因是：
- 项目依赖了 A 库，A 依赖
github.com/ugorji/go v1.1.4（含/codec子包） - 项目又直接 require 了
github.com/ugorji/go/codec v1.2.9（独立模块） - 两者路径重叠但模块声明不同：
github.com/ugorji/govsgithub.com/ugorji/go/codec，Go 认为这是两个“不同模块”却导出了同名包 - Go Modules 的
go list -m all会显示这两条记录，编译时就卡在歧义判断上
检查冲突来源的三步操作
先定位到底是谁引入了重复路径：
- 运行
go list -m -f '{{.Path}} {{.Version}}' all | grep ugorji，看是否输出多行 - 用
go mod graph | grep ugorji查谁间接拉入了旧版 - 打开
go.sum，搜ugorji/go，确认是否存在v1.1.4和v1.2.9两套校验和
修复方式：统一模块路径 + 版本锁定
不能靠删 go.sum 或清缓存解决，必须让 Go 知道“只认一个”：
立即学习“go语言免费学习笔记（深入）”；
- 在
go.mod中显式require github.com/ugorji/go v1.2.9（注意：不是/codec子路径） - 加一行
replace github.com/ugorji/go => github.com/ugorji/go v1.2.9，强制所有子包都走这个版本 - 执行
go mod tidy，它会自动删掉github.com/ugorji/go/codec这个独立模块声明 - 如果仍有报错，检查是否有其他依赖硬编码了
import "github.com/ugorji/go/codec"—— 这种写法本身就不合规，应改为import "github.com/ugorji/go/codec"并确保其属于github.com/ugorji/go模块下
容易被忽略的细节
replace 只对当前模块生效；CI 构建时若没清理 $GOMODCACHE，可能缓存旧版本导致本地正常、线上失败；go build -mod=readonly 会拒绝自动修改 go.mod，此时 go mod tidy 必须提前跑完。
