techknowlogick/xgo

xgo - Go CGO 交叉编译器

镜像概述和主要用途

xgo 是一个基于Docker的Go语言CGO交叉编译工具镜像，旨在解决Go程序中包含CGO依赖时的跨平台编译复杂性。它集成了必要的编译工具链和依赖库，允许开发者在单一环境中为多种目标操作系统和架构生成可执行文件，无需手动配置复杂的交叉编译环境。

核心功能和特性

• 多平台支持：支持为Linux、Windows、macOS等主流操作系统及多种CPU架构（如amd64、arm64等）编译程序。
• CGO依赖处理：自动处理CGO相关的系统库依赖，无需开发者手动安装目标平台的库文件。
• 简化配置：通过命令行参数直接指定目标平台，无需编写复杂的编译脚本。
• 工具链集成：内置Go编译器及目标平台的C/C++工具链，开箱即用。

使用场景和适用范围

• 开发包含CGO代码（如调用C库）的跨平台Go应用程序。
• 需要在单一开发环境中为多个目标平台构建可执行文件的场景。
• 自动化构建流程中集成跨平台编译步骤，提高构建效率。

使用方法和配置说明

基本使用示例

通过Docker运行xgo镜像，挂载本地Go项目目录并指定目标平台：

bash
docker run --rm -v $(pwd):/src techknowlogick/xgo -targets=linux/amd64,windows/amd64,macos/amd64 /src

参数说明：

• -v $(pwd):/src：将当前目录（Go项目根目录）挂载到容器内的/src目录。
• -targets：指定目标平台，格式为操作系统/架构，多个平台用逗号分隔（如linux/amd64,windows/amd64）。
• /src：容器内的项目路径（需与挂载路径对应）。

高级配置

更多配置选项（如指定Go版本、自定义CFLAGS/LDFLAGS等）可通过命令行参数或环境变量设置，详细说明请参考官方文档：https://github.com/techknowlogick/xgo/%E3%80%82

注意事项

• 确保本地Go项目已初始化（包含go.mod文件）。
• 目标平台的系统库依赖较复杂时，可能需要通过-deps参数指定额外依赖包。
• 详细的目标平台列表及兼容性信息请查阅官方文档。