Go 1.16+默认启用GO111MODULE=on，go build/run自动下载go.mod中声明的依赖；需先go mod init初始化模块，确保模块路径规范、网络可达及GOPROXY配置正确（如goproxy.cn）。
Go 1.16 及之后版本默认启用 GO111MODULE=on，go build 和 go run 会自动下载缺失的模块依赖（只要 go.mod 中已声明），无需手动执行 go get。关键在于项目初始化正确、模块路径清晰、网络环境可达。
确保项目已初始化为 Go 模块
若项目根目录下没有 go.mod 文件，go build 不会触发模块下载（而是回退到 GOPATH 模式）。需先运行：
-
go mod init（例如go mod init example.com/myapp）——生成go.mod - 后续所有命令（包括
go build、go run main.go）都会基于该模块解析和下载依赖 - 模块名不必真实存在，但建议符合域名格式，避免与标准库或常见包冲突
依赖必须在 go.mod 中显式声明
Go 不会“猜测”你要用什么第三方包。只有当你在代码中 import 并实际使用某个包（且该包不在标准库中），go build 或 go run 才会在首次构建时：
- 解析 import 路径（如
"github.com/gin-gonic/gin"） - 检查本地
$GOPATH/pkg/mod是否已缓存对应版本 - 若未命中，则自动从代理（如 proxy.golang.org）下载并写入
go.mod和go.sum
注意：仅 import 未使用的包，或使用 _import（如 import _ "net/http/pprof"）也会触发下载。
立即学习“go语言免费学习笔记（深入）”；
网络与代理配置影响自动下载成败
国内用户常因无法直连 proxy.golang.org 导致下载失败。可通过以下方式解决：
- 设置 GOPROXY：
go env -w GOPROXY=https://goproxy.cn,direct（推荐） - 临时覆盖：
GOPROXY=https://goproxy.cn go run main.go - 禁用代理（不推荐）：
go env -w GOPROXY=direct（需确保能直连 GitHub 等源） - 确认
go env GOPROXY输出非空且有效
验证与调试技巧
当自动下载未发生或失败时，可快速排查：
- 运行
go list -m all查看当前解析出的所有模块（含间接依赖） - 加
-v参数观察过程：go build -v会打印正在编译/下载的包 - 强制刷新缓存：
go clean -modcache后重试（慎用，会清空全部本地模块） - 检查
go.mod是否被意外修改（如误删某行 require）
不复杂但容易忽略。
