如何通过Zig实现从Intel Mac到M1 Mac的Rust代码交叉编译？

问题根源 #

你遇到的MismatchedCpuArchitecture错误，核心原因是：

• Zig脚本指定的目标平台不正确（aarch64-macos-none是裸机环境，而非macOS用户态），导致链接时误加载了本地x86_64架构的库
• .cargo/config.toml中错误设置了linker-flavor=ld，强制使用GNU ld链接器，与macOS原生的ld64不兼容

修正步骤 #

1. 调整Zig链接器脚本

将你的zig脚本修改为以下内容（改用bash提升兼容性，同时修正目标平台参数）：

#!/usr/bin/env bash
zig cc -target aarch64-apple-macos $@

执行命令赋予脚本可执行权限：

chmod +x ./zig

2. 简化.cargo/config.toml配置

删除错误的rustflags配置，只保留链接器指定：

[target.aarch64-apple-darwin]
linker = "./zig"

解释：

• 移除linker-flavor=ld：macOS默认使用ld64链接器，Rust会自动适配Zig的链接器调用
• 移除link-arg=-L/usr/local/opt/libiconv/lib：brew安装的libiconv是x86_64架构，交叉编译aarch64时无法使用，Zig会自动处理系统依赖

3. 执行编译

直接运行以下命令即可，无需设置CC环境变量（config中已指定链接器）：

cargo build --target aarch64-apple-darwin

验证结果 #

编译完成后，检查生成的可执行文件架构：

lipo -info target/aarch64-apple-darwin/debug/hello-world

输出应显示：Non-fat file: target/aarch64-apple-darwin/debug/hello-world is architecture: arm64

额外说明 #

如果你的项目确实需要依赖第三方库（如libiconv），不要使用本地x86版本，而是通过Zig的包管理或指定aarch64架构的库路径，确保所有依赖都是目标平台的架构。

内容的提问来源于stack exchange，提问作者JasonZhang