根本原因是当前目录不在GO111MODULE=on模式下的有效模块根目录或依赖未显式下载；需确保在项目根目录执行go mod init，运行go mod tidy解析并下载缺失依赖，并配置GOPRIVATE处理私有域名。
go mod init 之后仍报错“cannot find module providing package”
根本原因不是模块没初始化，而是当前目录不在 GO111MODULE=on 模式下的有效模块根目录，或依赖未显式下载。Go 不会自动拉取未声明的第三方包，即使本地有对应仓库。
- 检查是否在正确路径执行
go mod init：必须在项目根目录（含main.go或首个.go文件的目录），且该目录不能是 GOPATH 子目录（除非GO111MODULE=off） - 运行
go mod tidy强制解析并下载缺失依赖，它会读import语句、补全go.mod、写入go.sum - 若 import 路径含私有域名（如
git.example.com/mylib），需配置GOPRIVATE环境变量，否则 Go 默认走 proxy.golang.org，导致 404
GO111MODULE=auto 时在 GOPATH/src 下仍找不到本地包
当 GO111MODULE=auto（默认值），且当前路径在 $GOPATH/src 下，Go 会退化为 GOPATH 模式——此时只认 $GOPATH/src/xxx/yyy 结构的包，不读 go.mod，也不支持相对路径 import 或 replace。
- 临时解决：设
GO111MODULE=on，再跑go mod init和go mod tidy - 长期建议：彻底迁出
$GOPATH/src，把项目放在任意其他路径（如~/projects/myapp），避免 GOPATH 模式干扰 - 验证方式：执行
go env GO111MODULE，确认输出是on；再用go list -m all看是否列出模块而非空
go get 安装后 go build 仍报 missing package
go get 默认只下载并构建二进制（如命令行工具），**不会自动写入 go.mod**，除非加 -d（download only）或用于 import 的包已出现在源码中。
- 错误做法：
go get github.com/sirupsen/logrus→ 这只会把 logrus 装进pkg/mod，但go.mod不记录，下次 clean 后就失效 - 正确做法：先在
.go文件里写上import "github.com/sirupsen/logrus"，再运行go mod tidy - 若只想预下载（如 CI 缓存），用
go mod download，它按go.mod列表拉取，不修改文件
replace 或 exclude 导致依赖解析异常
replace 是双刃剑：它能指向本地调试分支或 fork，但也可能让 go build 加载了未预期的代码路径，尤其当被 replace 的模块本身又依赖其他版本时。
- 检查
go.mod中的replace是否拼写错误，比如把github.com/a/b写成github.com/a/b/v2，而实际 import 是无/v2的 - 运行
go list -m -u all查看哪些模块被 replace 影响，以及是否有 indirect 依赖冲突 - 临时禁用 replace：在
go build命令后加-mod=readonly，可快速判断是否 replace 引发问题
go env -w GOPRIVATE="git.example.com,github.company.com" go mod init myapp go mod tidy
真正卡住的时候，往往不是缺某个包，而是 Go 没意识到“你想要这个包”——它只信任 go.mod 里白纸黑字写的、或源码里明明白白 import 的东西。手动 go get、改环境变量、删 go.sum 都不如先确认 import 语句和 go mod tidy 是否同步。
