直接在目标平台安装官方 Go 二进制、启用 go.mod、用 GOOS/GOARCH 构建，再统一 VS Code + gopls 配置——这套组合能让你在 Windows/macOS/Linux 上获得一致的开发体验，而不是靠“一次编译到处运行”来幻想省事。
为什么别用系统包管理器装 Go
Ubuntu 的 apt install golang-go、macOS 的 brew install go 常滞后 1–2 个大版本，且路径不标准（比如 Ubuntu 可能装到 /usr/lib/go-1.19），导致 go env GOROOT 输出混乱，gopls 找不到 SDK。更麻烦的是，不同平台用不同包管理器，团队新成员初始化环境时极易踩坑。
- 正确做法：去 go.dev/dl 下载对应平台的最新稳定版压缩包（如
go1.22.6.linux-amd64.tar.gz） - 解压到固定路径：
/usr/local/go（Linux/macOS）或C:Go（Windows） - 把
$GOROOT/bin加入PATH，验证：go version和go env GOROOT输出应明确指向该路径
go.mod 是跨平台一致性的唯一锚点
不用 go.mod，就等于放弃跨平台可复现性。硬编码 GOPATH 或依赖本地 src/ 目录结构，会导致 macOS 上能跑的代码，在 Windows 上因路径分隔符或大小写敏感问题直接 panic。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 新建项目第一件事：
go mod init example.com/myapp（域名前缀不能是本地路径如./myapp） - 所有依赖必须走
go get，禁止手动改go.mod；提交时保留go.sum—— 它锁死每个依赖的 exact commit hash - 代码里路径拼接一律用
path/filepath.Join("conf", "config.yaml")，而非"conf/config.yaml" -
.gitignore中排除bin/、pkg/，但必须保留go.mod和go.sum
GOOS/GOARCH 构建必须显式指定，且注意 cgo 陷阱
GOOS=windows GOARCH=amd64 go build -o app.exe main.go 看似简单，但实际失败常因隐式依赖 cgo。比如用了 net 包的 DNS 解析（默认启用 cgo）、SQLite 或 OpenSSL，就会在非原生平台构建时报 exec: "gcc": executable file not found。
- 先检查是否启用了 cgo：
go env CGO_ENABLED，默认为1 - 纯 Go 标准库项目（无第三方 C 依赖）：可安全交叉编译，无需额外工具
- 含 cgo 的项目：要么禁用（
CGO_ENABLED=0，但部分功能会退化），要么用 Docker 构建 —— 例如在 Linux 宿主机上跑docker run --rm -v $(pwd):/work -w /work golang:1.22-alpine go build -o app-linux main.go - 常用组合别记错：
GOOS=linux GOARCH=arm64（不是arm），GOOS=darwin GOARCH=arm64（M1/M2 Mac），GOOS=windows GOARCH=386（32 位 Windows）
VS Code 配置必须项目级固化，不能靠手动设置
靠“每个人自己装插件、自己点开设置调格式化工具”，三天后团队代码风格就崩了。真正有效的同步方式，是把关键配置写死在项目里，克隆即生效。
- 在项目根目录建
.vscode/settings.json，内容至少包含："go.goroot": "/usr/local/go"（Linux/macOS）或"go.goroot": "C:\Go"（Windows）"go.formatTool": "gofumpt"（比gofmt更严格）"go.toolsManagement.autoUpdate": true（自动拉取gopls、dlv） - 禁用
go.gopath字段，或设为空字符串，强制走模块模式 - 把
.vscode/settings.json提交进 Git —— 新成员git clone后打开项目，gopls自动按该配置启动，路径分隔符、换行符、编码全部适配当前 OS - 每次换平台后，务必执行
go clean -cache -modcache再构建，否则旧缓存可能污染新平台产物
最常被跳过的其实是三件事：确认 go env 输出是否干净、坚持所有项目从 go mod init 开始、构建前清缓存。漏掉任何一条，跨平台就从“可控”变成“玄学”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
