跨平台构建需正确设置GOOS和GOARCH环境变量，依赖始终按host平台解析，仅build/run时应用目标平台约束；含cgo时须设CGO_ENABLED=0；vendor不区分平台，但模块须跨平台友好；私有模块拉取依赖GOPRIVATE和凭据配置；缓存污染是隐形陷阱，应定期go clean -cache -modcache。
Go 模块跨平台构建时 GOOS 和 GOARCH 怎么设才不踩坑
Go 本身支持跨平台编译，但模块管理（go.mod）本身不感知平台，真正影响跨平台行为的是构建阶段的环境变量。常见错误是以为改了 GOOS 就能自动拉取对应平台的依赖——其实所有依赖都按 host 平台解析和下载，只有 build 或 run 时才应用目标平台约束。
正确做法是：先确保模块在本地 clean 构建（go build），再用目标平台变量构建：
GOOS=linux GOARCH=arm64 go build -o myapp-linux-arm64 .GOOS=windows GOARCH=amd64 go build -o myapp.exe .- 若项目含 cgo 依赖（如
net包调用系统 DNS），需额外设置CGO_ENABLED=0避免 host 系统头文件干扰
如何让 go mod vendor 支持多平台依赖预置
go mod vendor 只会把当前 go list 解析出的依赖快照复制进 vendor/，它不区分平台。也就是说：你在 macOS 上 vendor 出来的代码，照样能用于构建 Linux 二进制——只要模块本身是纯 Go 或已通过 build tags 正确隔离平台逻辑。
关键点在于模块自身是否“跨平台友好”：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 检查第三方模块是否在
go.mod中声明了// +build或//go:build条件编译（如//go:build windows） - 避免在
vendor/后手动删改文件——go mod vendor不保证可重复性，建议配合go mod verify校验完整性 - CI 中若需多平台 vendor，只需在对应平台机器上跑一次
go mod vendor，无需为每个平台单独维护一份
交叉编译时遇到 undefined: syscall.XXX 怎么定位
这类错误几乎都源于 cgo 或 syscall 使用不当，而非模块管理问题。Go 的 syscall 包是按 GOOS/GOARCH 分支实现的，但部分符号只在特定组合下存在（比如 syscall.Getpagesize 在 Windows 上不存在）。
排查路径很直接：
- 用
go list -f '{{.Imports}}' std查看目标平台下syscall实际导入了哪些子包 - 在代码中用
//go:build !windows显式排除不兼容平台 - 优先使用
golang.org/x/sys/unix替代裸syscall，它对跨平台 syscall 封装更严谨 - 运行
go tool compile -x可看到实际参与编译的 .go 文件，确认条件编译是否生效
私有模块在不同平台 CI 中如何统一拉取
私有模块（如 GitLab、GitHub Private）的拉取行为与平台无关，全靠 go env GOPRIVATE 和 Git 凭据配置驱动。真正容易出问题的是 credential helper 或 SSH agent 转发。
实操建议：
- CI 中统一用 HTTPS + Personal Access Token（PAT），并设
GOPRIVATE=*.example.com避免走 proxy - 若必须用 SSH，确保每台 builder 机器的
~/.ssh/config中 Host 别名一致，且git config --global url."git@github.com:".insteadOf "https://github.com/" - 不要依赖
go mod download自动推断版本——显式指定 commit hash 或 tag（如module example.com/foo v1.2.3），防止不同平台解析出不同 pseudo-version
跨平台模块管理最易被忽略的一点：不是 go.mod 写法，而是你本地 GOROOT 和 GOPATH 是否干净，以及 CI 环境是否复用了旧的 pkg/ 缓存。哪怕 go build 成功，若缓存里混入了前次平台的 object 文件，也可能导致 runtime panic。每次切换平台前，执行 go clean -cache -modcache 更稳妥。
