根本原因是GO111MODULE未启用，需执行go env -w GO111MODULE=on并验证输出为on；常见干扰包括在$GOPATH/src下操作、残留vendor/或Gopkg.lock、import语句未真实引用、GOPROXY或GOPRIVATE配置错误。
go mod init 不生成 go.mod 或提示 “no modules found”
根本原因是 GO111MODULE 没启用，不是命令写错了。Go 1.16+ 虽默认开启模块模式，但很多终端（尤其是 CI 容器、旧 shell 配置）仍处于 auto 模式——它只在 $GOPATH/src 外且目录下已有 go.mod 才识别模块，/tmp 或新项目根目录直接被忽略。
必须执行：go env -w GO111MODULE=on，然后验证：go env GO111MODULE 输出应为 on。别信“应该默认开了”，手动设才是唯一可靠方式。
常见误操作：
- 在
$GOPATH/src下初始化，GO111MODULE=on会强制走模块路径，但容易和旧习惯冲突，建议新建空目录操作 - 用
go mod init不带参数，Go 会从当前路径猜 module name（如/home/user/myapp→myapp），命名不规范后续难迁移，显式写go mod init example.com/myapp - 目录里残留
vendor/或Gopkg.lock，干扰初始化，先rm -f go.mod go.sum vendor/ Gopkg.lock
go mod tidy 不下载依赖或 go.sum 为空
不是命令坏了，是 Go 没发现要拉什么包。Modules 只响应真实、可编译的 import 语句，不是“写了就行”。
立即学习“go语言免费学习笔记（深入）”；
检查这几处：
-
main.go或其他.go文件里是否有未注释的import "github.com/gin-gonic/gin"这类语句？字符串字面量（"github.com/xxx"）不算 - 是否 import 了但完全没调用？新版本 Go（1.22+）允许，老版本可能警告但不影响
tidy；如果真报imported and not used，加个_ = gin.Version即可触发识别 - 是否在错误目录运行？必须在
go.mod所在目录执行，且该文件第一行module xxx已正确写入 - 仍无效？加
-v看卡点：go mod tidy -v，输出里若出现Fetching但停住，大概率是GOPROXY没生效
go get 或 go mod download 卡住、超时、403
国内环境几乎必现，核心问题不是网络差，是 GOPROXY 没配对或格式错。
正确配置只有一条命令：go env -w GOPROXY=https://goproxy.cn,direct。注意：
- 逗号必须是英文半角，不能是全角、空格或分号；
direct是必需后缀，缺了私有模块会失败 - VS Code / GoLand 启动时可能没加载 shell 配置，直接在编辑器内置终端里运行
go env GOPROXY验证，不是看系统终端 - 某些 CI 脚本或 Makefile 显式覆盖
GOPROXY，检查构建日志里实际执行的命令是否含GOPROXY=... - 清华镜像（
https://mirrors.tuna.tsinghua.edu.cn/goproxy/）对含时间戳版本（如v0.0.0-20230101）支持更好，可替换试试
go env GOPROXY 输出必须严格等于该字符串，多一个空格都不行
私有仓库拉取失败：401 Unauthorized 或 404
即使 GOPROXY 正确，Go 仍会把私有域名（如 git.internal.company.com/lib/foo）当公开包发给代理，结果就是认证失败或 404。
必须设置 GOPRIVATE 告诉 Go：“这些域名跳过代理，直连”。命令示例：
go env -w GOPRIVATE="git.internal.company.com,github.com/myorg"
支持通配符：
go env -w GOPRIVATE="*.internal.company.com"
验证方式：go env GOPRIVATE 输出应包含你设置的域名，且无拼写错误。设完后重试 go get git.internal.company.com/lib/foo@v1.0.0，不再走 proxy.golang.org。
容易忽略的是：如果公司用 Nexus 或 Artifactory 自建 Go Proxy，GOPROXY 应设为内网地址（如 https://nexus.example.com/repository/goproxy/），同时保留 ,direct 作为 fallback。
