Go 项目打包成独立运行的 EXE 非常简单，核心依赖 Go 自带的 **跨平台编译工具链** 和 **静态链接特性**——无需额外依赖（如 .NET 运行时、VC++ 库），打包后的 EXE 可直接在 Windows 上双击运行，无需安装 Go 环境。
下面分「基础打包」「进阶优化」「跨平台打包」「常见问题」四部分，一步步教你操作（全程用命令行，无需复杂工具）。
### 一、前提条件
1. 已安装 Go 环境（推荐 1.16+，支持模块模式 `go mod`），并配置好环境变量（`GOPATH` 可选，Go 1.11+ 支持 `go mod` 无需依赖 `GOPATH`）。
2. 确认项目可正常运行（本地执行 `go run main.go` 能启动，无报错）。
### 二、基础打包：Windows 本地直接编译 EXE
适合在 **Windows 电脑上开发**，直接打包为 Windows 可执行文件（32/64 位可选）。
#### 步骤 1：进入项目根目录
打开 Windows 终端（CMD/PowerShell），cd 到你的 Go 项目根目录（即包含 `main.go` 或 `go.mod` 的目录）：
“`bash
cd D:\your-go-project # 替换为你的项目路径
“`
#### 步骤 2：执行编译命令
核心命令：`go build`，通过环境变量控制编译参数（无需修改代码）。
##### 1. 默认打包（64 位 EXE，与项目同名）
直接执行：
“`bash
go build
“`
– 效果：在项目根目录生成 `你的项目名.exe`（如项目文件夹叫 `demo`，则生成 `demo.exe`）。
– 特点：64 位（默认适配当前系统架构）、包含调试信息、体积稍大，可直接双击运行。
##### 2. 自定义 EXE 名称
想指定 EXE 文件名（如 `app.exe`），在命令后加 `-o` 参数：
“`bash
go build -o app.exe # 生成 app.exe
“`
##### 3. 打包 32 位 EXE（兼容旧 Windows）
如果需要在 32 位 Windows 上运行，指定架构为 `386`：
“`bash
# CMD 中执行（注意变量赋值格式）
set GOARCH=386
set GOOS=windows
go build -o app_32.exe
# PowerShell 中执行（变量赋值格式不同）
$env:GOARCH=”386″
$env:GOOS=”windows”
go build -o app_32.exe
“`
##### 4. 关键参数说明（确保独立运行）
Go 编译默认是 **静态链接**（除了 CGO 依赖），只需添加以下参数，彻底避免依赖系统 DLL：
“`bash
# 关闭 CGO（核心！避免依赖系统 MSVCRT.dll 等）
set CGO_ENABLED=0 # CMD
# 或 PowerShell：$env:CGO_ENABLED=”0″
# 编译为 Windows 64 位（默认）
set GOOS=windows
set GOARCH=amd64
# 执行打包（可合并为一行命令）
go build -o 最终文件名.exe main.go # main.go 可省略（默认编译当前目录所有包）
“`
– 为什么要关 CGO？：CGO 开启时，Go 会调用系统 C 库（如 Windows 的 `msvcrt.dll`），可能导致在部分纯净 Windows 系统上运行失败；关闭后完全静态链接，EXE 独立无依赖。
### 三、进阶优化：减小 EXE 体积 + 隐藏命令行窗口
默认打包的 EXE 可能有几 MB 到几十 MB，可通过以下优化压缩体积；如果是 GUI 项目（如用 `fyne`/`qt` 开发），还能隐藏命令行黑窗口。
#### 1. 压缩 EXE 体积（减小 50%+）
核心是 **去除调试信息** + 压缩编译，命令如下：
“`bash
# 1. 基础压缩（去除调试信息，推荐）
set CGO_ENABLED=0
set GOOS=windows
set GOARCH=amd64
go build -ldflags=”-w -s” -o app_small.exe
# 2. 极致压缩（需安装 UPX 工具）
# 第一步：下载 UPX（https://upx.github.io/），解压后将 upx.exe 加入系统 PATH
# 第二步：编译后用 UPX 压缩
go build -ldflags=”-w -s” -o app_temp.exe
upx -9 app_temp.exe -o app_final.exe # -9 是最高压缩级别
“`
– 参数说明：
– `-w`：去除 DWARF 调试信息（无法用 `gdb` 调试，但不影响运行）；
– `-s`：去除符号表（进一步减小体积）；
– UPX 压缩：无损压缩，不影响功能，体积可再减小 30%-70%（注意：部分杀毒软件可能误报 UPX 压缩的 EXE，需自行测试）。
#### 2. 隐藏命令行窗口（GUI 项目专用）
如果你的项目是 GUI 程序（如用 `fyne`、`walk`、`qt` 开发），打包后双击会先弹出黑窗口（命令行），可通过 `-ldflags=”-H windowsgui”` 隐藏：
“`bash
set CGO_ENABLED=0
set GOOS=windows
set GOARCH=amd64
go build -ldflags=”-w -s -H windowsgui” -o app_gui.exe
“`
– 效果：双击 EXE 直接启动 GUI 界面，无命令行黑窗口；纯控制台项目（如 API 服务、CLI 工具）不要加这个参数，否则无法看到输出日志。
### 四、跨平台打包：非 Windows 环境编译 Windows EXE
如果你的开发环境是 **Linux 或 Mac**，无需切换系统，直接通过环境变量指定目标平台为 Windows 即可（Go 跨平台编译的核心优势）。
#### 1. Linux 系统（如 Ubuntu）
打开终端，进入项目目录，执行：
“`bash
# 临时设置环境变量（仅当前终端有效）
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags=”-w -s” -o app_windows.exe
“`
#### 2. Mac 系统（Intel/M1 芯片）
打开终端，进入项目目录：
“`bash
# Intel 芯片（amd64 架构）
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags=”-w -s” -o app_windows.exe
# M1/M2 芯片（arm64 架构，适合 Windows on ARM 设备）
CGO_ENABLED=0 GOOS=windows GOARCH=arm64 go build -ldflags=”-w -s” -o app_windows_arm64.exe
“`
– 注意：跨平台编译时，`CGO_ENABLED` 必须设为 0（否则会依赖本地系统的 C 库，导致编译失败或运行报错）。
### 五、验证独立运行
打包完成后，测试是否真的「独立」：
1. 把生成的 EXE 复制到 **未安装 Go 环境的纯净 Windows 电脑**（或虚拟机）；
2. 双击 EXE，若能正常启动（GUI 弹出/服务运行/CLI 输出正常），则说明打包成功；
3. 若提示「缺失 xxx.dll」，大概率是没关 CGO，重新执行 `CGO_ENABLED=0` 编译即可。
### 六、常见问题排查
1. **编译报错「cannot find package」**：
项目依赖未下载，执行 `go mod tidy` 自动下载依赖后再编译。
2. **运行时提示「缺失 msvcrt.dll」**：
未关闭 CGO，重新用 `CGO_ENABLED=0` 编译。
3. **EXE 体积过大**：
未加 `-ldflags=”-w -s”`，或未用 UPX 压缩，按「进阶优化」步骤处理。
4. **跨平台编译失败**：
确保 Go 版本 ≥1.16，且 `CGO_ENABLED=0`，同时目标架构（`GOARCH`）正确（如 Windows 64 位是 `amd64`，32 位是 `386`）。
### 总结
Go 打包独立 EXE 的核心是「静态编译 + 关闭 CGO」，步骤简单：
1. 进入项目目录 → 2. 设置环境变量（`CGO_ENABLED=0 GOOS=windows GOARCH=amd64`）→ 3. 执行 `go build` + 可选优化参数。
– 纯控制台项目：`CGO_ENABLED=0 go build -ldflags=”-w -s” -o 文件名.exe`
– GUI 项目：`CGO_ENABLED=0 go build -ldflags=”-w -s -H windowsgui” -o 文件名.exe`
– 跨平台编译：在 Linux/Mac 上添加对应环境变量，命令一行搞定。
打包后的 EXE 无需任何依赖，可直接分发给他人运行，非常适合部署或分发工具/服务。