Go环境搭建必须确保go命令、GOROOT、GOPATH（或Go Modules）三者逻辑自洽，否则将引发编译、依赖和IDE连锁报错；GOROOT指向安装根目录，GOPATH定义工作区，GOPROXY需统一配置（如goproxy.cn），GO111MODULE控制模块启用模式，CGO_ENABLED=0影响二进制兼容性与体积，-ldflags="-s -w"用于生产环境瘦身但会丢失调试能力。
Go 环境搭不稳，后面所有编译、依赖、IDE 都会连锁报错。不是“装了就行”，而是必须让 go 命令、GOROOT、GOPATH（或 Go Modules 模式）三者逻辑自洽，否则 go build 可能成功但 go run 报错，或者 Goland 里 import 全红但终端能跑——这都不是环境“可用”，只是侥幸没触发冲突。
为什么 go version 能跑，但 go mod download 却超时？
本质是 Go 工具链和模块代理没对齐。终端用的 proxy 可能靠 shell 的 GOPROXY 环境变量，而 Goland 或 VS Code 的 Go 插件默认走自己的 HTTP 代理设置，两者不一致就导致 IDE 里依赖拉不下来。
- 先确认终端是否真通：运行
curl -v https://goproxy.cn，看是否返回 200 - 再统一配置：在终端执行
go env -w GOPROXY=https://goproxy.cn,direct，这会写入go env的全局配置，比临时export更可靠 - 如果公司内网有私有仓库，必须加
GOPRIVATE=git.internal.company.com，否则 Go 会强行走 proxy 去查公开索引，结果 404 - VS Code 的 Go 扩展需手动在设置里关掉 “Use Language Server” 以外的代理选项，避免和
go env冲突
CGO_ENABLED=0 不是万能开关，该开的时候不开会崩溃
禁用 CGO 确实能生成纯静态二进制，但代价是失去对系统库的调用能力。比如用 os/user 获取用户名、net 包做 DNS 解析，在某些发行版（如 Alpine）上会直接 panic，因为底层调用了 libc 的 getpwuid 或 getaddrinfo。
- 容器部署首选
CGO_ENABLED=0：Dockerfile 中写ENV CGO_ENABLED=0，配合GOOS=linux GOARCH=amd64，确保镜像里不带 libc 依赖 - 本地开发或需要 SQLite/cgo 绑定时，必须开
CGO_ENABLED=1，并确保系统装了gcc和musl-dev（Alpine）或build-essential（Ubuntu） - 交叉编译 Windows 或 macOS 时，
CGO_ENABLED必须为 0，否则构建会失败——Go 官方不支持跨平台 cgo 编译
go build -ldflags="-s -w" 到底删了什么？
-s 去符号表，-w 去 DWARF 调试信息，两者合用会让二进制失去堆栈追踪能力——线上 panic 日志只剩地址，没法反查源码行号。这不是“优化”，是生产环境的取舍。
立即学习“go语言免费学习笔记（深入）”；
- CI/CD 构建正式发布包时用：
go build -ldflags="-s -w" -o app，体积通常减少 30%~50% - 测试环境或内部工具保留调试信息：
go build -o app，出问题时可直接用delveattach - 想折中？只用
-ldflags="-w"：去掉 DWARF 但保留符号表，panic 日志仍能显示函数名 - 注意：加了
-ldflags后，runtime/debug.ReadBuildInfo()返回的Settings里vcs.revision可能为空，因为构建信息也被 strip 了
CentOS 7 上 go install 失败，别急着重装
CentOS 7 默认 glibc 版本低（2.17），而 Go 1.22+ 编译的工具（如 gopls、dlv）链接了较新的符号，运行时报 GLIBC_2.28 not found 是典型症状，不是 Go 本身装错了。
- 验证方式：运行
ldd $(which go)，看输出里有没有未定义的 GLIBC 符号 - 临时解法：降级到 Go 1.20.x（官方仍支持 glibc 2.17），命令是
go install golang.org/dl/go1.20@latest && go1.20 download - 长期方案：升级系统或改用 CentOS Stream 8/9，或在构建机（如 Ubuntu 22.04）上交叉编译，再把二进制拷过去
- 切记：不要用
yum install golang，CentOS 7 官源的 Go 是 1.8，连go mod都不支持
最易被忽略的一点：Go 的 GOROOT 和 PATH 必须指向同一份二进制。曾见有人 GOROOT=/usr/local/go，但 PATH 里优先放了 /home/user/go/bin，结果 go version 显示 1.22，go env GOROOT 却是 1.20——这种隐性错配，会在 go install 或 go test 时突然爆发，且难以定位。
