“no required module provides package”错误主因是包未声明为依赖或路径不存在；应先运行go mod init初始化模块，再用go get拉取完整模块而非子路径，注意版本后缀需与import和go.mod一致。
go mod tidy 报错 “no required module provides package”
这通常不是依赖“丢了”，而是 Go 不知道该从哪找这个包——它没被声明为项目依赖，或者路径根本不存在。
常见错误现象：no required module provides package github.com/cloudwego/hertz/pkg/app；终端还附带提示 to add it: go get github.com/cloudwego/hertz/pkg/app。
- 先确认项目已初始化模块：检查当前目录是否有
go.mod；没有就运行go mod init example.com/myapp（模块名可任意，不需真实域名） - 别直接
go get子路径（如github.com/cloudwego/hertz/pkg/app）——Hertz 是按 module 粒度发布的，应拉整个模块：go get github.com/cloudwego/hertz@latest - 如果用的是 v3+ 版本（比如 OpenIM SDK），注意路径含版本后缀：
github.com/openimsdk/openim-sdk-core/v3，v3必须写在 import 路径里，且go.mod中也得对应 - 执行
go mod tidy前，确保所有import语句都能在本地或远程解析到真实包；IDE 自动补全有时会给出错误路径（如漏掉/v3或拼错仓库名）
go build 时依赖未更新，符号 undefined
改了 server.go 里的函数，编译却报 undefined: foo.MyName——这不是代码写错了，是 Go 复用了旧的缓存编译产物。
根本原因：go install 后生成的 .a 文件（如 $GOPATH/pkg/linux_amd64/server.a）被 go build main.go 直接链接，跳过了源码重编译。
立即学习“go语言免费学习笔记（深入）”；
- 绝对不要单独编译单个文件：
go build main.go是陷阱，它脱离包上下文，无法触发依赖重建 - 正确做法是进项目根目录（含
go.mod），运行go build -o ./bin/app .（末尾的.表示当前模块所有包） - 若仍不生效，先清掉模块缓存：
go clean -modcache，再go mod tidy+go build . - 现代项目强烈建议完全弃用 GOPATH；只要
GO111MODULE=on（默认已是），go build就只认go.mod和当前源码，不再受pkg/干扰
go get 指定版本不生效，总拉 latest
go get github.com/sirupsen/logrus@v1.9.3 执行后，go.mod 里写的却是 v1.13.0——这不是命令失效，是 Go 的最小版本选择（MVS）在起作用。
它不会降级已有更高兼容版本（比如你之前引入过 v2.0.0+incompatible），也不会无条件接受你指定的 tag，除非该 tag 真实存在且满足约束。
- 先验证 tag 是否存在：
curl -s https://proxy.golang.org/github.com/sirupsen/logrus/@v/v1.9.3.info | jq .version，返回空说明 tag 不存在 - 想精确锁定，不用
go get，改用go mod edit -require=github.com/sirupsen/logrus@v1.9.3，再跑go mod tidy - 如果依赖本身没打 tag，可用 commit hash：
go get github.com/sirupsen/logrus@55046e2 - 注意：
@latest不等于main分支，而是满足 semver 的最高 patch 版本，可能跳过预发布版
replace 与 vendor 共存时构建失败
加了 replace 指向本地路径，又跑了 go mod vendor，结果 go build -mod=vendor 还是报错——问题出在 vendor 目录没包含 replace 后的真实源码。
go mod vendor 只复制 go.mod 中声明的依赖，对 replace 的本地路径默认忽略，除非你手动把对应目录 cp 进 vendor/。
- 开发阶段用
replace没问题，但上线前必须移除或改用go mod edit -dropreplace，否则 CI 构建会失败 - 真要离线构建，
go mod vendor后，还需手动同步 replace 路径：cp -r ../my-local-pkg vendor/github.com/xxx/my-local-pkg -
go build -mod=vendor必须显式加，否则即使有 vendor 目录，Go 仍会走GOPROXY拉包（尤其当 vendor 缺少间接依赖时） - vendor 目录变更后，务必
git add vendor/ && git commit，否则协作时别人拉不到一致依赖
go mod tidy 看似简单，实际可能触发网络请求、本地缓存查找、MVS 计算、甚至 go.sum 校验失败。最容易被忽略的是：**你看到的报错位置，往往不是问题源头，而是下游传导结果**。 
