go build 可生成静态单文件可执行程序：默认静态链接，跨平台需设GOOS/GOARCH，cgo依赖时加CGO_ENABLED=0，模块依赖用go mod tidy对齐，生产环境加-ldflags="-s -w"裁剪调试信息。
用 go build 生成单文件可执行程序
Go 默认就能把整个项目（含依赖）编译成一个静态链接的二进制文件，无需运行时环境。关键命令就是 go build，不是 go run 或 go install。
- 在项目根目录（含
main.go的地方）直接执行go build，会生成当前平台默认名称的可执行文件（如 Linux 下是./projectname） - 指定输出名：加
-o参数，例如go build -o myapp ./cmd/myapp（路径指向含func main()的包） - 跨平台编译需提前设环境变量，比如在 macOS 上编译 Windows 版：
GOOS=windows GOARCH=amd64 go build -o myapp.exe . - 默认生成的是静态二进制，但若项目用了
cgo（如调用 SQLite、OpenSSL），则可能动态链接 libc，此时加CGO_ENABLED=0强制纯静态（部分功能会不可用）
处理依赖和模块路径问题
Go 1.11+ 默认启用 module 模式，go build 会自动读取 go.mod 解析依赖。常见失败往往不是语法错，而是路径或版本没对齐。
- 确保项目根目录有
go.mod：没有就先运行go mod init example.com/myapp（模块名不一定要真实域名，但需唯一） - 如果提示
cannot find module providing package xxx，说明 import 路径和本地模块名/依赖版本不匹配，运行go mod tidy自动修正 - 第三方包被
替换过（如用
replace指向本地 fork），打包前务必确认go build能成功，否则生成的二进制仍会尝试拉原版模块 - 私有仓库依赖需配置
git认证或GOPRIVATE环境变量，否则go build会卡在 fetch 阶段
减小体积与关闭调试信息
默认生成的二进制带 DWARF 调试符号，体积偏大且可能泄露源码路径。生产打包建议裁剪。
- 去掉调试信息：加
-ldflags="-s -w"，其中-s去除符号表，-w去除 DWARF 信息，典型写法：go build -ldflags="-s -w" -o app . - 启用小型化编译（Go 1.20+）：加
-gcflags="-l"关闭函数内联，有时能小幅降体积（但可能影响性能，非必要不加） - 注意：加了
-s -w后，pprof和栈追踪会丢失文件名和行号，仅剩函数名；调试时应保留这些 flag - 用
upx进一步压缩（非官方支持）：如upx --best app，但某些杀软会误报，CI/CD 中慎用
Windows 下生成无控制台窗口的 GUI 程序
Go 编译出的 Windows 可执行文件默认带黑框（控制台），做 GUI 工具时需要隐藏它。
- 在
main.go文件顶部添加注释指令：//go:build windows，并在同一文件中 import"syscall"（或使用github.com/therecipe/qt等 GUI 库时自动处理） - 更通用的做法是加链接器标志：
go build -ldflags="-H windowsgui" -o app.exe .—— 这会让 Windows 加载器不分配控制台 - 注意：一旦用了
-H windowsgui，fmt.Println等输出将静默丢弃，无法通过 cmd 查看日志；建议改用日志文件或系统事件查看器记录 - 若用
CGO_ENABLED=1调用 WinAPI，需确保syscall或golang.org/x/sys/windows版本兼容，否则可能启动崩溃
CGO_ENABLED 开关上。尤其是本地开发用 go run 没问题，一打包就报 “undefined reference” 或 “no such file”，大概率是 cgo 相关的链接问题或模块未 tidy 干净。
