根本原因是当前目录未被Go识别为有效模块作用域。常见情形包括：路径在$GOPATH/src下导致强制GOPATH模式、GO111MODULE非on、根目录无.go文件、go.mod命名非法、GOROOT配置错误、GOPRIVATE未设致私有包404、go get不更新go.mod，且所有验证须在非$GOPATH/src的项目根目录执行。
不是代理没配好，而是当前目录根本不在 module 模式下有效作用域里。
go mod init 之后还报 cannot find module providing package
这说明 go mod init 虽然执行了，但 Go 并没真正把它当模块用。常见原因有：
- 当前路径在
$GOPATH/src下——哪怕GO111MODULE=on，Go 也会强制退回到 GOPATH 模式，忽略go.mod -
go env GO111MODULE输出是auto或off，而不是on - 项目根目录里没有
.go文件（比如只有main.go但你误放在子目录），go mod init生成的go.mod不会被后续命令识别 - 执行
go mod init时没指定模块名，或模块名含非法字符（如空格、中文），导致后续 import 解析失败
GO111MODULE=on 但 go build 仍找不到标准库包（如 fmt）
这不是依赖问题，是 GOROOT 指向错误。现象是：go version 成功，但 go run main.go 报 cannot find package "fmt"。
- 运行
go env GOROOT，确认输出路径下存在src/fmt目录 - 如果 Go 是从 tar.gz 手动解压安装的（非 pkg/dnf/apt），
GOROOT必须显式设置，不能依赖默认值 - Windows 上常见错误：解压到
D:\go，但GOROOT设成D:\go\（末尾斜杠）或D:\Go（大小写不一致） - Linux/macOS 上注意符号链接：若
/usr/local/go是软链，确保它最终指向一个完整安装（含pkg和src）
go mod tidy 卡住或报 404，私有域名包无法拉取
本质是 Go 默认走 proxy.golang.org，而你的 import 路径（如 git.example.com/mylib）被当成公开地址去查，结果 404。
立即学习“go语言免费学习笔记（深入）”；
- 必须配置
GOPRIVATE=git.example.com（多个用逗号分隔），告诉 Go 这些域名不走代理 - 同时建议设
GOProxy=https://goproxy.cn,direct，direct表示对GOPRIVATE列出的域名直连 - 验证是否生效：运行
go env GOPRIVATE和go env GOProxy，输出应与设置一致 - 注意：环境变量需在 shell 启动时加载，新开终端后要重新 source 或重开终端
go get 不写入 go.mod，导致下次构建失败
go get 默认行为是下载并构建二进制，**不修改 go.mod**。所以即使 go get github.com/sirupsen/logrus 成功，go build 仍会报错。
- 正确做法：先在
.go文件中写import "github.com/sirupsen/logrus"，再运行go mod tidy - 如果只是想预下载（如 CI 缓存），用
go mod download，它只读go.mod，不改文件 - 避免
go get -u直接升级——它可能跳过go.mod校验，引入不兼容版本；优先用go get github.com/xxx@v1.2.3显式指定
最常被忽略的一点：所有检查都要在项目根目录做，且该目录不能是 $GOPATH/src 的子目录——哪怕只差一层，Go 都会切换模式。别信“我刚 init 过”，先 pwd 看路径，再 go env GO111MODULE 和 go list -m 验证。
