"cross"：开箱即用的 Rust 跨平台编译，轻松无忧

你是否遇到过这样的情况：需要为某个特殊架构构建 Rust 项目？比如 ARM 开发板、嵌入式系统，甚至不同的 Linux 发行版？通常这会变成一场真正的冒险：安装特定的工具链、配置环境、与链接器和依赖项搏斗。几个小时，甚至几天，都在努力让一切正常工作。如果你不仅需要构建，还需要在目标平台上测试代码呢？

这就是 cross 登场的时刻——一个承诺"零配置"跨平台编译和跨平台测试 Rust crate的项目。听起来像魔法，不是吗？本质上，cross 处理了与准备跨编译环境相关的所有常规工作，使用 Docker 或 Podman 容器。让我们探索这个工具如何显著简化 Rust 开发者的生活。

什么是 cross，谁需要它？

cross 是 cargo（Rust 标准包管理器和构建系统）的一个包装器。但 cross 不是使用本地工具链，而是在一个专门准备的容器内运行构建或测试过程。可以把它想象成一台虚拟机，但要轻量得多，而且专门针对跨编译这一特定任务。在这个容器内，你所需的一切都已就绪：交叉工具链、库，以及为目标架构构建所需的所有组件。

谁会觉得这有用？几乎所有需要以下功能的 Rust 开发者：

• 嵌入式系统开发：ARM 微控制器、树莓派、其他单板计算机。
• 移动开发：为 Android 构建组件。
• 创建服务器应用：面向各种 Linux 发行版或架构（如云服务器上的 AArch64）。
• 开发跨平台工具：应能在 Windows、Linux、各种 BSD 系统上运行。
• 自动化 CI/CD：让测试和构建在任何构建机器上都能同样可靠地运行。

cross 的主要优势：魔法在行动

cross 以几个关键能力脱颖而出，使其成为真正有价值的工具：

1. "零配置"——不再与环境搏斗

这可能是 cross 最大的"特性"。不再需要手动安装 gcc-arm-none-eabi、配置 linker scripts，或搜索正确版本的 libc。容器内所需的一切都会由 cross 处理。你只需要安装好 Docker 或 Podman，当然还需要 rustup 来管理 Rust 工具链。之后，你只需指定目标架构，cross 就会完成剩余的工作。

2. 跨平台测试：不仅是构建，还要验证！

为不同架构构建代码只是成功的一半。确保代码实际能运行要困难得多。cross 不仅可以编译，还可以使用 QEMU 模拟为目标平台运行测试。这是一种令人难以置信的强大能力，让你能及早发现 bug，而无需等待部署到真实硬件上。

想象一下：你在为 AArch64 编写代码，却可以在 x86_64 笔记本电脑上运行测试。cross 让这成为现实。当然，QEMU 有其局限性（例如，多线程测试可能运行缓慢或出现错误），但对于大多数单元测试来说，这简直是救命的。

3. 最广泛的目标平台支持

看看项目的 README——支持的目标列表简直令人惊叹！从 Android 到各种 Linux 版本的 ARM、MIPS、PowerPC、RISC-V、S390x、Sparc，当然还有 Windows 和 FreeBSD。甚至还有通过 Emscripten 支持的 WASM。这意味着 cross 可以成为你最多样化项目的通用工具。

示例：cross test 为 aarch64-unknown-linux-gnu 架构运行测试

它是如何工作的：容器和模拟的一点魔法

cross 的核心原理是使用容器。当你调用 cross build --target <target-triple> 时，cross 会搜索或下载该目标架构的预定义 Docker（或 Podman）镜像。在这个镜像内，一切都已配置好：编译器、链接器、库。你的代码被挂载到这个容器中，cargo 在其中运行。

对于跨平台测试，cross 使用QEMU和 Linux 内核的 binfmt_misc 功能。binfmt_misc 允许内核运行其他架构的可执行文件，自动通过 QEMU 代理它们。这样，当 cross test 运行一个为 ARM 编译的二进制文件时，内核"理解"这不是本机可执行文件，并将其传递给 QEMU 进行模拟。

这个优雅的解决方案将所有跨编译依赖项与你的主机系统隔离，保持系统整洁和稳定。

开始使用 cross：比看起来更容易

如果你已经安装了 rustup 和其中一种容器引擎（Docker 或 Podman），安装 cross 非常简单：

cargo install cross --git https://github.com/cross-rs/cross

或者你可以从 GitHub Releases 下载预编译的二进制文件。安装后，使用 cross 与使用 cargo 几乎相同：

# Сборка проекта для ARM64 Linux
cross build --target aarch64-unknown-linux-gnu

# Запуск тестов для MIPS64 Linux
cross test --target mips64-unknown-linux-gnuabi64

# Компиляция с дополнительными флагами Rustc
cross rustc --target powerpc-unknown-linux-gnu --release -- -C lto

如你所见，你只需要在 build、test 或 run 命令前加上 cross，指定目标平台，然后——瞧！你的 Rust 程序可以为完全不同的架构编译，甚至进行测试！

灵活的按需配置

cross 还提供广泛的自定义功能。你可以配置构建行为、容器镜像、环境变量等。配置可以存储在 Cargo.toml（在 [workspace.metadata.cross] 部分）、项目根目录下的单独 Cross.toml 文件中，甚至通过环境变量传递。这让开发者能够最大程度地灵活地将 cross 适配到特定项目需求。例如，你可以向镜像添加额外的系统依赖或指定你自己的 Docker 镜像。

谁会特别受益于 cross？

• 嵌入式系统开发者：如果你用 Rust 为微控制器或单板计算机编写固件，cross 将为你节省大量环境配置时间。
• 跨平台库或应用开发团队：确保你的代码在所有支持的平台上正确运行将变得容易得多。
• CI/CD 工程师：将 cross 集成到你的流水线中，将允许你自动化构建和测试多个目标，确保更可靠的发布。
• 尝试新架构的人：想在 RISC-V 或 PowerPC 上尝试 Rust？cross 将提供一个现成的环境，无需设置虚拟机和手动配置编译器。

结论：值得尝试 cross 吗？

绝对值得！如果你曾经经历过 Rust 跨编译的痛苦，cross 将是你真正的发现。它不仅仅是一个工具，更是一种"开箱即用"的理念，让你专注于编写代码而不是与工具链搏斗。易用性、强大的跨平台测试能力和广泛平台支持，使其成为任何认真从事 Rust 开发的开发者的必备工具。

所以，如果你还没有尝试过 cross，也许是时候给它一个机会，永远告别大多数跨编译问题。安装它、尝试它，它很可能会与你长期相伴！