直接装好go后必须配置go111module=on、goproxy=https://goproxy.cn,direct、gosumdb=sum.golang.org三要素，否则国内环境下依赖下载易超时、模块校验失败；调试还需额外添加-go build -gcflags="all=-n -l"禁用优化以查看变量。
直接装好 Go 就能编译运行，但没配 GO111MODULE、GOPROXY 和调试参数，十有八九会在拉依赖或调试时卡住——尤其是国内网络环境下。
go version 能跑 ≠ 环境配好了
很多新手执行 go version 成功就以为万事大吉，结果 go mod download 报 timeout，dlv debug 打印变量显示 optimized away。核心问题不在 Go 本身，而在三个没显式配置的环节：
-
GO111MODULE=on：不设这个，go.mod文件会被忽略，退化成老式GOPATH模式，依赖路径混乱 -
GOPROXY没配国内源：默认走proxy.golang.org，国内基本连不上，go get会 hang 2 分钟后失败 - 没关编译优化：
go build默认开启内联和变量优化，Delve 调试时看不到局部变量值
国内环境必须配的三条 env 命令
无论 macOS、Windows 还是 Linux，只要终端能用，就执行这三条（PowerShell 用户把 export 换成 $env: 语法）：
go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct go env -w GOSUMDB=sum.golang.org
注意：direct 在 GOPROXY 末尾不能少，它表示“代理找不到时回源官方校验”，避免私有模块或新发布包拉不到；GOSUMDB 设为 sum.golang.org 是为了跳过国内无法访问的校验服务，改用代理自带的 checksum 验证。
验证是否生效：
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
go env | grep -E "(GO111MODULE|GOPROXY|GOSUMDB)"
调试时必加的 -gcflags="-N -l"
Delve 调试时变量消失、断点跳过、调用栈扁平，基本都是因为没禁用优化。正确做法不是全局关优化，而是在调试编译时显式传参：
-
go build -gcflags="-N -l" -o myapp main.go：只对当前构建生效，不影响发布版 -
go build -gcflags="all=-N -l"：加上all=确保所有依赖包也禁用优化（尤其用到 cgo 或 vendor 时） - 别用
-gcflags="-m"查优化——那是给性能分析用的，输出巨长且无调试价值
如果项目用了 cgo，还要额外加 CGO_ENABLED=0，否则 -N -l 可能被绕过。
生产构建和调试构建要严格分离
很多人图省事，把 -N -l 写进 Makefile 或 CI 脚本里长期开着，结果上线二进制体积翻倍、启动变慢、符号表泄露。记住：
- 开发调试：用
go build -gcflags="all=-N -l"+dlv exec ./myapp - CI 打包：用
go build -ldflags="-s -w"去符号表和调试信息 - 带版本号发布：用
go build -ldflags="-X main.version=$(git describe --tags)"
交叉编译时同样适用——比如 GOOS=linux CGO_ENABLED=0 go build -gcflags="all=-N -l"，既能调试 ARM64 容器镜像，又不会污染生产镜像。
最容易被忽略的是：-N -l 必须在 go build 阶段加，而不是 dlv test 时才补——后者只会让测试二进制带调试信息，主程序依然优化过。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
