一、跨平台编译基础原理

程序员一般开发是在window上或mac上，而运行大都是在liunx上，虽然可以把代码copy到服务器上进行编译，但毕竟有点麻烦，所以一般都是进行跨平台的交叉编译；

Go 语言凭借其强大的跨平台编译能力，让开发者只需一套代码，就能轻松编译出适应不同操作系统和架构的可执行文件。这种能力的实现主要得益于 Go 语言编译时的静态链接特性，它无需依赖目标平台的运行环境，就能生成独立的可执行文件。跨平台编译的核心在于对两个关键环境变量的设置：

• GOOS：代表目标操作系统，常见的取值有 linux、darwin（macOS）、windows 等。
• GOARCH：表示目标操作系统的架构，像 386（x86 32 位）、amd64（x86 64 位）、arm（ARM 架构）都是其常见值。

二、不同平台的编译命令

（一）Windows 平台

1. 命令提示符（CMD）

要编译适用于 Linux ARM 平台的程序，可按如下步骤操作：

set GOOS=linux
set GOARCH=arm
go build -o hello hello.go

2. PowerShell

环境变量的设置方式则有所不同：

$env:GOOS = "linux"
$env:GOARCH = "arm"
go build -o hello hello.go

3. 多平台编译命令汇总

• 编译 Linux 程序：

SET CGO_ENABLED=0
SET GOOS=linux
SET GOARCH=amd64
go build -o app_linux app.go

• 编译 macOS 程序：

SET CGO_ENABLED=0
SET GOOS=darwin
SET GOARCH=amd64
go build -o app_mac app.go

• 编译 Windows 程序（指定架构）：

SET CGO_ENABLED=0
SET GOOS=windows
SET GOARCH=386
go build -o app_win32.exe app.go

（二）macOS 平台

• 编译 Linux 程序：

CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app_linux app.go

• 编译 Windows 程序：

CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o app_windows.exe app.go

（三）Linux 平台

• 编译 macOS 程序：

CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o app_mac app.go

• 编译 Windows 程序：

CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o app_windows.exe app.go

三、CGO 依赖处理技巧

当项目依赖 CGO 时，编译过程会变得复杂一些，因为这需要目标平台的 C 编译器支持。以下是几种常见场景的处理方法：

（一）Linux 编译 ARM 程序

CGO_ENABLED=1 GOOS=linux GOARCH=arm CC=arm-linux-gnueabi-gcc go build -o app_arm app.go

（二）Windows 编译带 CGO 的 Linux 程序

这种情况下，需要先安装 MinGW 或 TDM - GCC 等交叉编译工具链，然后执行以下命令：

SET CGO_ENABLED=1
SET GOOS=linux
SET GOARCH=amd64
SET CC=x86_64 - w64 - mingw32 - gcc
go build -o app_linux app.go

四、编译参数优化策略

（一）减小可执行文件体积

通过添加 -ldflags "-w -s" 参数，能够有效减小可执行文件的大小：

go build -ldflags "-w -s" -o app_min app.go

其中，-w 参数的作用是去掉调试信息，-s 参数则是去掉符号表。

（二）调试环境编译设置

若需要使用 gdb 或 delve 等调试器对 Go 程序进行调试，编译时应使用 -gcflags "-N -l" 参数禁止编译器优化：

go build -gcflags "-N -l" -o app_debug app.go

五、常见问题排查方法

（一）“CGO_ENABLED = 1 but no C compiler found” 错误

当遇到这个错误时，表明系统中缺少 C 编译器。你需要安装对应平台的 C 编译器，例如在 Linux 上安装 GCC，在 Windows 上安装 MinGW 或 TDM - GCC。

（二）程序运行时出现动态链接库缺失的问题

若程序依赖 CGO，那么生成的可执行文件可能会依赖目标平台的动态链接库。解决这一问题有两种方法，一是静态链接所有依赖库，二是确保目标平台已安装相应的运行时库。

六、批量编译脚本示例

为了方便编译多个架构，可以编写一个脚本来自动编译多个目标平台。以下是一个示例 Bash 脚本：

#!/bin/bash

OUTPUT_DIR="build"
PLATFORMS=("linux/amd64" "linux/arm64" "windows/amd64" "darwin/amd64")

mkdir -p $OUTPUT_DIR

for PLATFORM in "${PLATFORMS[@]}"; do
    OS=$(echo $PLATFORM | cut -d'/' -f1)
    ARCH=$(echo $PLATFORM | cut -d'/' -f2)
    OUTPUT_NAME=$OUTPUT_DIR/hello-$OS-$ARCH

    if [ $OS = "windows" ]; then
        OUTPUT_NAME+='.exe'
    fi

    echo "Building for $OS/$ARCH..."
    GOOS=$OS GOARCH=$ARCH go build -o $OUTPUT_NAME main.go
done

使脚本可执行：

chmod +x build.sh

运行脚本：

./build.sh

这个脚本会在 build 目录中生成多个目标平台的可执行文件。