bdwyertech/go-crosscompile

Go交叉编译镜像（基于Alpine Linux）

镜像概述

该镜像基于Alpine Linux构建，专为Go语言的交叉编译设计，支持CGO（C语言互操作）功能，主要面向Mac、Windows和Linux ARM64平台，提供轻量且高效的跨平台编译环境。

核心功能与特性

• CGO支持：集成必要的C/C++编译器，满足带CGO依赖的Go项目编译需求
• 多平台覆盖：支持Mac（x86_64）、Windows（x86_64）及Linux ARM64平台的交叉编译
• 轻量基础：基于Alpine Linux，镜像体积小，资源占用低，适合快速集成到CI/CD流程

使用场景

适用于需要为多平台（尤其是Mac、Windows或Linux ARM64）开发并编译包含CGO组件的Go应用程序的开发者，简化跨平台编译环境配置。

使用方法与配置说明

环境变量配置

根据目标平台，需设置以下环境变量启用CGO编译：

Mac平台（x86_64）

bash
export CGO_ENABLED=1
export CC=o64-clang
export CXX=o64-clang++

Windows平台（x86_64）

bash
export CGO_ENABLED=1
export CC=x86_64-w64-mingw32-gcc
export CXX=x86_64-w64-mingw32-g++

Linux ARM64平台

bash
export CGO_ENABLED=1
export CC=aarch64-linux-musl-gcc
export CXX=aarch64-linux-musl-g++

基础使用示例（Docker Run）

挂载本地Go项目目录并执行跨平台编译：

bash
# 示例：编译Windows平台应用
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  docker.xuanyuan.run/bdwyertech/go-crosscompile \
  sh -c "
    export CGO_ENABLED=1 \
           CC=x86_64-w64-mingw32-gcc \
           CXX=x86_64-w64-mingw32-g++ && \
    go build -o app-windows.exe main.go
  "

说明：将$(pwd)替换为本地Go项目根目录，main.go替换为项目入口文件，app-windows.exe为目标输出文件名。根据目标平台调整环境变量即可编译对应平台的可执行文件。