go mod是Go 1.11+标准依赖管理机制，必须设GO111MODULE=on并配置GOPROXY国内镜像，新建项目需执行go mod init后立即运行go mod tidy以补全依赖、生成go.sum并校验完整性。
go mod 是 Go 1.11+ 的标准依赖管理机制，**不启用它，新项目无法正确拉取、记录或校验依赖**。全新环境必须显式激活模块支持，否则 go get 会失败、go build 可能忽略第三方包、IDE（如 GoLand 或 VS Code）也无法识别依赖树。
go env -w GO111MODULE=on 必须执行
Go 1.16+ 默认开启模块模式，但部分系统（尤其是旧版安装包或手动解压安装）仍可能 fallback 到 auto 模式——即仅当当前目录存在 go.mod 时才启用模块。这会导致：
• 在空目录下执行 go get 报错 go: no modules found
• go run main.go 成功，但导入第三方包（如 github.com/gorilla/mux）时编译失败
• go mod init 被绕过，go.sum 不生成，校验缺失
执行以下命令强制全局启用：
go env -w GO111MODULE=on
验证是否生效：
go env GO111MODULE
输出必须是 on，不是 auto 或空值。
立即学习“go语言免费学习笔记（深入）”；
GOPROXY 必须设为国内镜像
默认代理 https://proxy.golang.org 在国内基本不可用，表现为：
• go mod download 卡住或超时
• go get 报错 timeout 或 no matching versions
• go mod tidy 失败，且不提示具体原因
推荐设置（任选其一）：
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
go env -w GOPROXY=https://goproxy.cn,direct
或
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
direct 表示当镜像站无该包时回源官方地址，避免漏包；不要省略逗号和 direct。
go mod init 后立即 go mod tidy
新建项目后只执行 go mod init example.com/hello 是不够的：
• go.mod 里只有 module 和 go 版本声明
• 未声明的依赖（比如代码里写了 import "github.com/spf13/cobra"）不会自动写入 go.mod
• 缺少 go.sum，后续构建可能因校验失败中断
正确流程是：
- 在项目根目录执行
go mod init example.com/hello - 写好
main.go并确保有第三方 import - 立即运行
go mod tidy—— 它会：- 解析所有
import，补全require条目 - 下载对应版本并写入
go.sum - 移除未使用的依赖（比
go get -u更干净）
- 解析所有
GOROOT 通常不用动，GOPATH 已可忽略
新版 Go（1.13+）对 GOPATH 的依赖大幅降低：
• go mod 项目可放在任意路径，无需塞进 $GOPATH/src
• go install 默认把二进制放到 $GOBIN（若未设，则为 $GOPATH/bin），但日常开发几乎不用 go install
• GOPATH 唯一常见用途是存放 go 工具链插件（如 gopls），VS Code 或 GoLand 会自动处理
真正要确认的是 GOROOT：
• 运行 go env GOROOT，输出应为 Go 安装路径（如 C:\Go 或 /usr/local/go）
• 如果为空或错误路径，说明安装未成功或 PATH 未生效，需重装或检查环境变量
• 不建议手动设置 GOROOT，除非你同时维护多个 Go 版本
go mod tidy 和 GOPROXY 配置。很多人以为 go mod init 就算完成，结果第二天写业务逻辑时卡在 go get 上，反复重试却没意识到代理没开——这种问题在全新环境里高频发生，且报错信息极其模糊。 
