build
Go 语言在运维和部署领域**“大杀四方”**的核心特性之一：静态链接与交叉编译 (Static Linking & Cross Compilation)。
相比于 Java 需要安装 JRE，Python 需要 pip install 一堆依赖，Node.js 需要巨大的 node_modules，Go 编译出来的就是一个单纯的二进制文件。把它扔到服务器上，直接 chmod +x 就能跑，不需要任何环境配置。
作为架构师，我来教你如何“一键生成”适配各种系统的可执行文件，以及这里面隐藏的3个工程化深坑。
🚀 实战：把你的 User System 打包
假设你现在的开发环境是 Windows，但你最终要把程序部署到 Linux 服务器（这是最常见的场景）。
请在你的项目根目录打开终端（PowerShell）：
1. 打包给 Windows (本地用)
这是最简单的，直接编译：
PowerShell
# -o 后面指定输出的文件名
# 最后是 main.go 所在的路径
go build -o user-server.exe cmd/api-server/main.go- 结果：你会发现目录下多了一个
user-server.exe。双击它，或者在命令行运行./user-server.exe，你的服务就启动了！
2. 打包给 Linux (生产环境用) 🔥
这是 Go 的黑魔法。你不需要安装 Linux 虚拟机，直接在 Windows 上就能编出 Linux 可以在跑的程序。
在 PowerShell 中执行：
PowerShell
# 1. 设置目标系统为 Linux
$env:GOOS="linux"
# 2. 设置目标架构为 amd64 (大多数服务器的架构)
$env:GOARCH="amd64"
# 3. 执行编译
go build -o user-server-linux cmd/api-server/main.go
# 4. (可选) 编译完后记得把环境变量改回来，否则下次你就在本地跑不起来了
$env:GOOS="windows"- 结果：你会得到一个叫
user-server-linux的文件（没有后缀）。 - 部署：把这个文件上传到 Linux 服务器，执行
chmod +x user-server-linux然后./user-server-linux，服务就跑起来了。
3. 打包给 Mac (比如 M1/M2 芯片)
PowerShell
$env:GOOS="darwin" # Mac 的内核叫 darwin
$env:GOARCH="arm64" # M1/M2 芯片是 arm64，老款 Intel Mac 是 amd64
go build -o user-server-mac cmd/api-server/main.go🛑 架构师经验：打包发布的“三大坑”
虽然 Go 的打包很爽，但在企业级开发中，如果不注意以下三点，部署时一定会报错。
坑一：CGO 的陷阱 (CGO_ENABLED)
如果你的代码里引用了某些依赖 C 语言库的包（比如早期的 SQLite 驱动，或者某些图像处理库），交叉编译会失败，因为 Windows 上没有 Linux 的 C 编译器。
架构师建议：为了保证绝对的可移植性，我们通常会强制关闭 CGO，构建纯 Go 的二进制文件。 PowerShell
$env:CGO_ENABLED="0"这就要求你选用的第三方库必须支持纯 Go 实现（Pure Go）。幸运的是，我们用的 GORM 和 MySQL 驱动都是纯 Go 的，没问题。
坑二：配置文件的“遗忘”
新手最容易犯的错：
“我把
user-server-linux扔到服务器上了，启动报错：panic: failed to connect database！”
原因：可执行文件里只包含了代码，不包含你的 config.yaml 或 .env 文件，也不包含 HTML 模板或图片。 解决：
- 传统做法：把二进制文件和配置文件一起上传到服务器。
- 进阶做法 (Go 1.16+)：使用
embed特性，把配置文件直接“以此进制形式”塞进 exe 文件里。这样真的就变成“单文件走天下”了。
坑三：时区问题 (Timezone)
如果你的服务器是用 Docker 跑的一个极简 Linux (如 Alpine)，它可能连“时区数据”都没有。 现象：程序里获取 time.Now()，结果打印出来的时间和北京时间差 8 小时，或者数据库存的时间不对。 解决：
- 在 Dockerfile 里安装
tzdata包。 - 或者在 Go 代码里加载本地时区文件（如果不依赖系统）。