新版go（1.16+）默认启用go111module=on且不强制依赖gopath，go env gopath为空属正常，gopath仅用于存放二进制和pkg/mod缓存，项目只需有go.mod即可在模块模式下正常工作。
go env 显示 GOPATH 为空？别急着改配置
新版 Go（1.16+）默认启用 GO111MODULE=on，且不再强制依赖 GOPATH 存放项目代码。如果你执行 go env GOPATH 返回空或默认路径（如 $HOME/go），但项目仍能正常 go run 或 go build，说明你已在模块模式下工作——此时项目根目录有 go.mod，GOPATH 仅用于存放 go install 的二进制和 pkg/mod 缓存，不影响日常开发。
容易踩的坑：
- 误以为
GOPATH必须指向项目目录，强行修改后导致go get下载的包被写入错误位置 - 在模块项目里还把源码放到
$GOPATH/src，结果go mod tidy不识别、依赖混乱 - 用
go install安装工具（如gopls）时，没把$GOPATH/bin加进PATH，导致命令找不到
交叉编译时 CGO_ENABLED=0 不生效？检查这三点
想生成纯静态 Linux 二进制却报 undefined reference to `clock_gettime' 或运行时报 libc not found，大概率是 CGO_ENABLED=0 没真正生效。
实操建议：
- 必须在
go build命令前显式设置：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app main.go，不能只设GOOS/GOARCH - 确认没有在代码中使用
// #cgo或import "C"—— 只要存在任一 cgo 调用，CGO_ENABLED=0就会直接报错退出 - 如果项目依赖了含 cgo 的第三方包（如
net包在某些系统上触发 cgo），加-a参数强制重编所有依赖：CGO_ENABLED=0 GOOS=linux go build -a -o app main.go
国内拉包总超时？GOPROXY 配置不是设一次就完事
GOPROXY=https://goproxy.cn,direct 是基础配置，但实际中常因网络波动或镜像同步延迟失败。单纯执行 go env -w GOPROXY=... 并不保证后续所有操作都走代理。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
关键点：
- 执行
go env GOPROXY确认输出确实是设置的值，而不是空或https://proxy.golang.org - 若用 IDE（如 GoLand），需检查其内置终端是否继承了系统环境变量；VS Code 用户要确认
go.toolsEnvVars设置里也包含GOPROXY - 遇到
go mod download卡住，可临时加-v查看具体哪个模块失败，再单独试：go mod download -v github.com/some/pkg@v1.2.3 - 备用代理可多配一个，比如
GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct
go build -o 输出路径带空格或中文？小心 Windows 下的陷阱
在 Windows 上执行 go build -o "D:\my project\app.exe" 看似合理，但某些旧版 Go（≤1.20）或 PowerShell 环境下会因路径解析异常导致输出失败或文件名错乱。
稳妥做法：
- 避免路径含空格和中文，用短路径代替，例如
D:\proj\app.exe - PowerShell 中用反引号转义空格：
go build -o "D:\my` project\app.exe"，但不如直接规避 - 若必须用长路径，改用 CMD 执行，或把路径用双引号包裹并确保当前 shell 未对引号做额外处理
- CI/CD 脚本中统一用正斜杠 + 英文路径，如
go build -o ./bin/app.exe，兼容性更好
环境变量和构建参数的组合效应比表面看起来更微妙，尤其是 CGO_ENABLED 和 GOOS 的共存逻辑、GOPROXY 在不同子命令中的生效时机，这些地方稍不留神就会让构建结果和预期不一致。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
