根本原因是Go模块只认go.mod中声明的依赖路径，不自动加载未声明的本地或GOPATH包；需用replace显式指向本地副本，并运行go mod tidy同步，同时确认GO111MODULE=on、GOPROXY配置及go.sum一致性。
本地打包 Go 项目时出现 cannot find module 或 no required module provides package，根本原因不是“包丢了”，而是 Go 模块感知不到你期望的依赖路径——它只认 go.mod 里声明的版本，且默认不读取 $GOPATH/src 或任意本地目录下的未声明代码。
为什么 go build 在本地找不到已 go get 过的包？
Go 1.11+ 启用模块模式后，go get 默认写入的是远程仓库地址（如 github.com/sirupsen/logrus），而非本地路径。即使你把源码 clone 到本地并修改过，只要没在 go.mod 中显式替换，go build 就不会加载它。
- 运行
go mod graph | grep logrus可确认当前解析的实际模块路径和版本 -
go list -m all显示所有启用的模块及其来源（注意看是否有=>表示 replace） - 如果本地改过某个依赖但没
replace，构建时仍会拉取原始版本，导致行为不一致
用 replace 指向本地修改过的依赖
这是最常用也最安全的方式：告诉 Go 模块“这个包我用自己的副本”。必须写在 go.mod 文件中，且路径需为绝对路径或相对于 go.mod 的相对路径（推荐绝对路径，避免 CI/CD 中路径错乱）。
- 执行
go mod edit -replace github.com/sirupsen/logrus=/home/you/src/logrus - 手动编辑
go.mod，在末尾加一行：replace github.com/sirupsen/logrus => /home/you/src/logrus - 确保本地路径下有有效的
go.mod（哪怕只是空文件），否则go build会报missing go.mod - 替换后记得运行
go mod tidy，否则可能残留旧版本缓存
打包时依赖仍缺失？检查 go.sum 和代理设置
即使 go.mod 正确，go build 也可能因校验失败或代理拦截而静默跳过依赖下载。
立即学习“go语言免费学习笔记（深入）”；
- 删掉
go.sum并重新go mod tidy——尤其当你从别人 repo clone 后首次构建时，go.sum中的 checksum 可能和你本地环境不匹配 - 临时关闭代理：
export GOPROXY=direct，排除公司 proxy 或 GOPROXY 配置错误导致的拉取失败 - 检查
GO111MODULE=on是否生效（可通过go env GO111MODULE确认），off 状态下模块功能被禁用 - 若依赖是私有 Git 仓库，确保
git config --get credential.helper已配置，否则go get会卡在认证环节
真正容易被忽略的是：replace 只在本模块生效，子模块若单独 go build，不会继承父级的 replace 规则；另外，Docker 构建时若 COPY 顺序不对（比如先 COPY . 再 RUN go mod download），也会导致本地 replace 路径失效——因为容器里根本没有那个绝对路径。
