Go项目打包发布可用go build直接生成单个可执行文件，但需注意跨平台编译、依赖嵌入、版本信息注入、图标与窗口配置等问题；推荐通过GOOS/GOARCH交叉编译、-ldflags注入变量、embed.FS打包资源，并在干净环境验证。
Go 项目打包发布不需要构建工具链或复杂配置，go build 就能产出可执行文件；但直接扔二进制出去容易出问题——比如跨平台编译失败、依赖未嵌入、版本信息缺失、Windows 下缺少图标或控制台窗口闪退。
用 go build 打包单个可执行文件
最简方式就是运行 go build，它会把当前目录的 main 包编译成二进制：
go build -o myapp ./cmd/myapp
注意点：
-
-o指定输出名，不加则默认生成与目录同名的可执行文件（如myapp） - 路径必须指向含
func main()的main包，不能是普通库路径 - 默认使用当前系统 GOOS/GOARCH 编译，想发给 Linux 用户就得在 Linux 或用交叉编译
- 所有依赖（包括标准库）默认静态链接，无需额外打包
.so或安装 Go 环境
交叉编译不同平台二进制（Linux/macOS/Windows）
Go 原生支持跨平台编译，但 Windows 上生成 macOS 二进制、或 macOS 上生成 Windows 二进制，都必须显式设置环境变量：
立即学习“go语言免费学习笔记（深入）”；
GOOS=linux GOARCH=amd64 go build -o myapp-linux-amd64 ./cmd/myapp GOOS=windows GOARCH=386 go build -o myapp-win32.exe ./cmd/myapp GOOS=darwin GOARCH=arm64 go build -o myapp-macos-arm64 ./cmd/myapp
常见组合：
-
GOOS=windows：输出带.exe后缀（即使没写），且默认启用控制台窗口；如需 GUI 应用（无黑窗），加-ldflags "-H windowsgui" -
GOARCH=386和GOARCH=amd64是 x86 家族主流；arm64对应 Apple Silicon 和部分服务器 - 不建议用
GOARM（已弃用），Raspberry Pi 用GOOS=linux GOARCH=arm64即可
嵌入版本号、编译时间等构建信息
靠 go build -ldflags 注入变量，需先在代码里声明一个全局字符串变量（如 var Version string），再用 -X 覆盖：
go build -ldflags="-X 'main.Version=v1.2.3' -X 'main.BuildTime=$(date -u +%Y-%m-%dT%H:%M:%SZ)'" -o myapp ./cmd/myapp
要点：
-
-X格式为importpath.name=value，比如github.com/user/app.Version；若变量在main包，就写main.Version - 值中含空格或特殊字符必须用单引号包裹（Shell 层面），否则会被截断
-
$(date ...)在 Linux/macOS 可用，Windows CMD 不支持，可用 PowerShell 替代或预生成时间字符串 - 避免注入敏感信息（如密钥），
-ldflags内容可被strings命令轻易提取
发布前检查和最小化分发包
打完包别急着上传，先做几件事：
- 用
file myapp（Linux/macOS）或Get-Command myapp.exe（PowerShell）确认目标平台和架构是否正确 - 在干净环境（如 Docker 容器或虚拟机）里运行，验证是否真不依赖外部动态库（
ldd myapp应只显示linux-vdso和libc等极少数） - 如果项目含静态资源（HTML/CSS/图片），别忘了用
embed.FS打包进二进制，而不是指望用户手动复制assets/目录 - 最终分发包通常只需一个二进制 + LICENSE + README.md；无需源码、
go.mod或测试文件
真正麻烦的不是打包动作本身，而是确保不同平台下行为一致——比如 Windows 路径分隔符、时区处理、信号中断响应，这些都不会在 go build 阶段报错，却会在用户机器上静默失败。
