go version命令未找到的根本原因是path环境变量未正确配置：windows需重启终端使msi安装的c:\program files\go\bin生效；macos/linux手动安装需在~/.zshrc或~/.bashrc中添加export path=$path:/usr/local/go/bin并执行source命令；vs code终端须关闭重开才能继承新环境变量。
go version 命令没反应或报错：PATH 没配对
装完 Go 但 go version 提示“命令未找到”，基本是 PATH 没生效。Windows 上 .msi 安装器默认加了 C:\Program Files\Go\bin，但必须重启 CMD/PowerShell 才能读取新环境变量；macOS/Linux 如果手动解压安装，得自己往 ~/.zshrc 或 ~/.bashrc 里加 export PATH=$PATH:/usr/local/go/bin，然后 source ~/.zshrc。
常见坑：
- 用 VS Code 终端验证前，先关掉再重开——它不会自动继承系统新环境变量
- Windows 用户在 PowerShell 里执行
go env，发现GOROOT是空的，大概率是安装时勾选了“Add to PATH”但没重启终端 - Linux 上用
apt install golang装的版本常是旧版（如 Ubuntu 22.04 默认是 go1.18），go version输出会偏低，建议优先用官方二进制包
go mod init 后 go.sum 为空或依赖拉不下来：GOPROXY 没设好
运行 go mod init myapp 后，首次 go get 或 go build 卡住、超时、报 proxy.golang.org: i/o timeout，说明国内网络没走代理。Go 1.13+ 默认启用模块，但默认代理 https://proxy.golang.org 在国内基本不可用。
必须执行：
-
go env -w GO111MODULE=on（虽新版默认开启，但显式设更稳妥） -
go env -w GOPROXY=https://goproxy.cn,direct（七牛云镜像，稳定且支持校验） -
go env -w GOSUMDB=sum.golang.org（若公司内网需禁用校验，可设为off，但不推荐）
验证：go env | grep GOPROXY 应输出你刚设的地址。设完立刻生效，不用重启 shell。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
交叉编译失败：GOOS/GOARCH 参数写错或不兼容
想用 macOS 编译 Windows 可执行文件，执行 GOOS=windows GOARCH=amd64 go build -o app.exe 却报 cannot compile for windows/amd64 on darwin/arm64，不是语法错，是 Go 版本太老或目标平台不支持。
注意点：
- Go 1.20+ 才原生支持
darwin/arm64→windows/amd64交叉编译；低于此版本需额外工具链或虚拟机 -
GOARCH值不能瞎写：arm64不等于aarch64，Go 只认arm64；386是 32 位 x86，不是x86 - 某些第三方库含 C 代码（如
net包部分实现），跨平台编译时可能因 CGO 禁用而失败，此时要加CGO_ENABLED=0
go build 生成的二进制体积大：没开 -ldflags
一个只打印 “Hello” 的程序，go build 出来动辄 2MB+，远超预期。Go 默认静态链接所有依赖（包括 libc），且保留调试符号。
瘦身方法：
-
go build -ldflags="-s -w" -o app main.go：去掉符号表（-s）和 DWARF 调试信息（-w），体积通常减半 - 若不依赖 cgo，加
CGO_ENABLED=0可避免动态链接 libc，进一步缩小并提升移植性 - 生产发布建议用
upx压缩（upx --best app），但注意部分杀软会误报，CI 流水线慎用
真正容易被忽略的是：-ldflags 必须写在 go build 命令最后，参数顺序错会导致静默忽略——比如 go build -o app -ldflags="-s -w" main.go 里 -ldflags 就无效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
