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

昌言小师

187人浏览 · 2026-07-09 16:05:37

昌言小师 · 2026-07-09 16:05:37 发布

. 内置 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 版本#
老系统福音 🎉

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

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

✅ 5. 重写 clang 包装工具#
使用 C# 重写，行为更可控：

严格处理 clang 参数
自动移除 -Wl,–export-dynamic 和多余的 --target
✅ 6. 新增 ar 包装工具#
配置了 Static 的静态库项目也能进行 AOT 发布

性能如何#
编译流程#
Native AOT 的编译大体分为两步：

托管代码编译（IL → 目标文件）：.NET 自带 cross-compiler，在 Windows 上就能将 C# / F# 等托管代码编译为对应 Linux 目标架构的 .o 目标文件。
链接（目标文件 → 最终产物）：将上一步产生的 .o 文件及各种运行时库链接为最终产物，支持三种输出形态：
可执行文件 — dotnet publish 默认行为
共享库 — Shared
静态库 — Static，需要 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 项目中添加引用即可：

Copy

2️⃣ 像往常一样 Publish#
在 Windows 上直接运行：

Copy