使用 PublishAotClang 轻松交叉编译 Linux Native AOT

前言

Native AOT 是 .NET 的一大利器，但如果你主要在 Windows 开发机 上工作，想把程序 AOT 发布到 Linux（glibc / musl、x64 / arm64 / arm），会面临以下难题：

• AOT 不支持跨操作系统的编译，你得准备 Linux 系统来编译
• 在 Linux 上跨 CPU 架构编译非常麻烦，一套环境配多套 sysroot 让人崩溃
• glibc 版本受宿主系统限制，编译出的程序在老系统（如 CentOS 7）上很可能跑不起来

为了解决这些问题，我把之前 fork 的 PublishAotCross 彻底重构了一遍，做成了 PublishAotClang。

GitHub：https://github.com/xljiulang/PublishAotClang

PublishAotClang 是什么？

一句话说明：

PublishAotClang 是一个 NuGet 包，用 Zig 包装成 Clang 工具链环境，专门帮助你在 Windows 上把 .NET 项目 PublishAot 到多种 Linux RID。

它并不是运行时，也不是编译器本体，而是一个 构建环境注入器。

解决了哪些痛点？

✅ 1. 内置 Zig 工具链（Windows 免装）

引用的是 Vezel.Zig.Toolsets，NuGet 还原即可使用：

• 不需要你手动装 Zig
• 不需要配 PATH
• CI 与本地开发环境一致性极高

✅ 2. 默认支持 strip，减少二进制体积

内置 objcopy，Native AOT 默认就会裁剪符号：

• 去掉调试符号
• 显著减小最终可执行文件大小
• 不需要你额外写 post-build 脚本

✅ 3. 自带 libz 静态库

这是很多同学容易忽略的一点：

• .NET 8.0 的 AOT 本身不包含 libz
• 交叉编译时经常找不到 libz

PublishAotClang 内置了由 zig build zlib-1.3.2 编译得到的静态库，开箱即用。

✅ 4. 支持指定 glibc 版本

老系统福音 🎉

你可以在项目属性中指定：

<GLibcVersion>2.17</GLibcVersion>

这样即使你的项目基于 .NET 10，也能在 CentOS 7 这类老系统上正常运行。

✅ 5. 重写 clang 包装工具

使用 C# 重写，行为更可控：

• 严格处理 clang 参数
• 自动移除 -Wl,--export-dynamic 和多余的 --target

✅ 6. 新增 ar 包装工具

配置了 <NativeLib>Static</NativeLib> 的静态库项目也能进行 AOT 发布

性能如何

编译流程

Native AOT 的编译大体分为两步：

1. 托管代码编译（IL → 目标文件）：.NET 自带 cross-compiler，在 Windows 上就能将 C# / F# 等托管代码编译为对应 Linux 目标架构的 .o 目标文件。
2. 链接（目标文件 → 最终产物）：将上一步产生的 .o 文件及各种运行时库链接为最终产物，支持三种输出形态：
   • 可执行文件 — dotnet publish 默认行为
   • 共享库 — <NativeLib>Shared</NativeLib>
   • 静态库 — <NativeLib>Static</NativeLib>，需要 ar 工具归档

PublishAotClang 只影响第二步——Native AOT 在链接时会在系统中寻找 clang、objcopy、ar 等工具，PublishAotClang 包装了模拟 Linux 环境的工具，将这些调用透明地转发给 Zig 工具链，从而产出 Linux ELF 格式的二进制文件。

性能结论

编译出的程序性能和在 Linux 上直接编译完全一致。 原因很简单：

• .NET 的 IL → 目标文件这一核心编译路径由 .NET 自身的 cross-compiler/RyuJIT 完成，与操作系统无关
• 链接器只负责把目标文件拼装成最终产物，不改变代码逻辑和优化决策
• Zig 工具链生成的 ELF 与 Linux 原生工具链完全兼容

所以无论你是在 Windows 上用 PublishAotClang 编译，还是在 Linux 上用 dotnet publish，最终二进制文件的运行表现、指令集、内存布局都没有差别。你可以在 Windows 上放心编译，程序拿到 Linux 上运行，性能和原生编译无异。

怎么用？

1️⃣ 引用 NuGet 包

在你的 Native AOT 项目中添加引用即可：

<PackageReference Include="PublishAotClang" Version="1.*" />

2️⃣ 像往常一样 Publish

在 Windows 上直接运行：

# glibc（适用于 Ubuntu、Debian、CentOS 等）
dotnet publish -r linux-x64
dotnet publish -r linux-arm64
dotnet publish -r linux-arm           # .NET 9+

# musl（适用于 Alpine Linux；无外部共享库依赖时，也可在 glibc 环境下运行）
dotnet publish -r linux-musl-x64
dotnet publish -r linux-musl-arm64
dotnet publish -r linux-musl-arm      # .NET 9+

全程无需 WSL、无需 Docker、不用远程 Linux 编译机。

总结

PublishAotClang 的目标很简单：

让 Windows 上的 .NET Native AOT 真正能够交叉编译到 Linux。

如果你也在折腾 Native AOT，尤其是跨平台发布这块，欢迎试用、提 issue 或 PR 🙌

GitHub：
https://github.com/xljiulang/PublishAotClang

---

本文由 jiulang 原创，转载请注明出处