Go 1.16+ 默认启用模块模式，但必须显式设置 GO111MODULE=on、GOPROXY=https://goproxy.cn,direct 和 GOSUMDB=sum.golang.org（或 off），并确保 GOROOT 和 PATH 正确，三者缺一不可。
Go 1.16+ 默认启用模块模式，不依赖 GOPATH，但必须正确设置 GOROOT 和 PATH；国内用户不配代理，go mod download 会卡死或超时。
验证 go 命令是否真正可用
很多用户执行 go version 成功，却在后续运行 go run main.go 或 go mod init 时报错，根本原因是 PATH 没生效或指向了错误路径。
- Windows 用户安装 .msi 后，必须关闭并重新打开所有 CMD/PowerShell 窗口，否则环境变量不会加载
- macOS/Linux 用户改完
~/.zshrc或~/.bash_profile后，要执行source ~/.zshrc，不能只靠重启终端 - 运行
which go（macOS/Linux）或where go（Windows），确认输出路径与go env GOROOT一致；若不一致，说明系统调用的是另一个 go - 常见错误现象：
command not found: go或go: unknown subcommand "mod"，基本都是 PATH 问题
必须配置的三个环境变量（国内用户）
仅靠安装程序自动配置不够，尤其在国内网络环境下，缺一不可。
-
GO111MODULE=on：强制启用模块模式，避免旧版 GOPATH 行为干扰；即使 Go 1.16+ 默认开启，也建议显式设置防止 CI/CD 环境误判 -
GOPROXY=https://goproxy.cn,direct：七牛云镜像，比 proxy.golang.org 稳定；direct是 fallback，确保私有模块仍可拉取 -
GOSUMDB=sum.golang.org：校验包完整性；若被墙，可改为GOSUMDB=off（仅开发环境临时用，生产禁用） - 设置命令统一用
go env -w，例如：go env -w GOPROXY=https://goproxy.cn,direct - 验证方式：
go env | grep -E "(GO111MODULE|GOPROXY|GOSUMDB)"
初始化项目时绕不开的 go mod 命令
不用 go mod init 就直接写代码，IDE 或 go build 可能无法识别依赖，甚至编译失败。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 进入空目录后，先执行
go mod init example.com/myapp（模块名建议用域名格式，哪怕只是本地项目） - 生成的
go.mod文件里第一行是module声明，不能留空或写成相对路径 - 添加依赖时不要手动改
go.mod，用go get github.com/sirupsen/logrus，它会自动写入并下载 - 清理未使用依赖：执行
go mod tidy，它会删掉go.mod中冗余项，并补全间接依赖 - 常见错误：
go: go.mod file not found in current directory or any parent，就是没初始化模块
GoLand 中 SDK 配置失效的典型表现
GoLand 提示 “No Go SDK found” 或代码无语法提示、跳转失效，大概率不是没装 Go，而是 IDE 没认对路径。
- 打开
File → Settings → Go → GOROOT，路径必须精确到 Go 安装根目录（如/usr/local/go或C:\Go），不能选到bin子目录 - 不要勾选 “Use GOPATH that’s defined in system environment”，现代项目应完全忽略
GOPATH；若勾选，IDE 可能强行读取旧工作区导致冲突 - 首次打开含
go.mod的项目时，GoLand 会自动识别模块并下载gopls（Go language server）；若卡在 “Installing tools”，检查代理是否生效，或手动在Settings → Go → Tools中点击 Install - 调试失败常见原因：
dlv版本与 Go 不兼容（如 Go 1.25 需 dlv v1.24+），建议用go install github.com/go-delve/delve/cmd/dlv@latest更新
最易被忽略的一点：go mod 初始化后的模块名一旦写错，后续所有 go get 导入路径都得跟着错——改名不是改 go.mod 一行那么简单，得同步调整所有 import 语句和 replace 规则。
