本文详解 go 1.4+ 版本下交叉编译失败的根本原因（`use of internal package not allowed` 错误），并提供现代、安全、无需源码编译的官方推荐方案。
Go 自 1.5 版本起已原生支持跨平台交叉编译，且不再需要手动编译 Go 工具链或修改 $GOROOT/src。你遇到的 use of internal package not allowed 错误，本质上是 Go 1.4 引入的 internal 包导入限制机制所致——该机制严格禁止非同级路径（如 cmd/）导入 src/internal 或 src/cmd/*/internal 中的包。而旧教程中执行 ./make.bash 试图为 Windows 重新构建整个 Go 工具链，恰恰触发了这一检查，导致 cmd/pprof 等命令因非法引用 cmd/pprof/internal/... 而失败。
⚠️ 重要提示：切勿再尝试 cd $GOROOT/src && ./make.bash 进行交叉编译。该方式仅适用于 Go 1.3 及更早版本；自 Go 1.4 起已被废弃，且 Arch Linux 通过 pacman 安装的 Go（通常为最新稳定版）默认启用 internal 规则，强行构建必然报错。
✅ 正确做法：零配置交叉编译（Go 1.5+）
现代 Go 完全支持开箱即用的交叉编译，只需设置两个环境变量：
# 编译为 Windows 64 位可执行文件（.exe） GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go # 编译为 Windows 32 位可执行文件 GOOS=windows GOARCH=386 go build -o myapp-32.exe main.go # 编译为 macOS ARM64（示例扩展） GOOS=darwin GOARCH=arm64 go build -o myapp-darwin main.go
✅ 优势：
- 无需 root 权限；
- 不修改 Go 源码或工具链；
- 支持 CGO_ENABLED=0（纯静态链接，无 C 依赖）；
- 兼容所有主流 Go 版本（1.5–1.23+）。
? 注意事项与最佳实践
-
禁用 CGO 是关键：Windows 交叉编译时，务必设置 CGO_ENABLED=0（默认已禁用），否则会因缺失 Windows C 工具链而失败：
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -o app.exe main.go
-ldflags="-s -w" 可减小二进制体积并移除调试信息。
避免 GOBIN 干扰：确保未设置 GOBIN 或其路径不包含非标准工具链，否则可能意外调用旧版 go 命令。
验证目标平台：运行 go env GOOS GOARCH 查看当前默认目标；交叉编译时环境变量仅对单次命令生效，不影响全局。
第三方包兼容性：若项目使用 cgo（如数据库驱动、加密库），则无法纯静态交叉编译到 Windows；此时需在 Windows 主机上构建，或使用 Docker（如 golang:1.23-windowsservercore-ltsc2025）。
? 总结
你遇到的错误不是 Go 的 Bug，而是旧教程与新版 Go 语义不兼容的典型表现。Go 官方早已将交叉编译“平民化”——它不再是底层构建难题，而是一个简洁的环境变量组合。放弃 make.bash，拥抱 GOOS/GOARCH，即可安全、高效、可复现地生成跨平台二进制。对于 Arch Linux 用户，只需 sudo pacman -S go 保持最新版，即可立即享受现代化 Go 构建体验。
