编译目标 target ​

核心概念 ​

编译目标(target)是 Rust 编译器输出代码所面向的平台,用一个"目标三元组"(target triple)表示,格式为 <架构>-<厂商>-<操作系统>-<环境>。例如 x86_64-unknown-linux-gnu 表示 64 位 x86 架构、Linux 操作系统、GNU C 库环境。默认情况下 Cargo 为当前主机平台编译,通过 --target 参数可以交叉编译到其他平台。

Rust 通过 rustup target add 安装目标平台的标准库,通过 cargo build --target 进行交叉编译。不同目标的支持程度分为三个等级(Tier 1/2/3),Tier 1 保证可以构建和通过测试。

bash
# 查看当前主机目标
# rustc --print target-list | findstr windows
# rustc --version --verbose

# 安装新的编译目标
# rustup target add x86_64-unknown-linux-gnu
# rustup target add wasm32-unknown-unknown
# rustup target add aarch64-linux-android

# 查看已安装的目标
# rustup target list --installed

# 交叉编译
# cargo build --target x86_64-unknown-linux-gnu
# cargo build --target wasm32-unknown-unknown

常见目标三元组 ​

目标说明
x86_64-pc-windows-msvcWindows 64位 MSVC
x86_64-pc-windows-gnuWindows 64位 MinGW
x86_64-unknown-linux-gnuLinux 64位 GNU
x86_64-unknown-linux-muslLinux 64位 musl(静态链接)
aarch64-unknown-linux-gnuLinux ARM64
x86_64-apple-darwinmacOS Intel
aarch64-apple-darwinmacOS Apple Silicon
wasm32-unknown-unknownWebAssembly
wasm32-wasip1WebAssembly WASI
aarch64-linux-androidAndroid ARM64
aarch64-apple-iosiOS ARM64
thumbv7em-none-eabihfARM 嵌入式(无OS)

配置默认目标 ​

toml
# .cargo/config.toml 中配置默认目标
# 这样 cargo build 不需要每次加 --target

[build]
target = "x86_64-unknown-linux-musl"    # 默认目标

# 交叉编译的链接器配置
[target.x86_64-unknown-linux-gnu]
linker = "x86_64-linux-gnu-gcc"

[target.aarch64-unknown-linux-gnu]
linker = "aarch64-linux-gnu-gcc"

[target.x86_64-unknown-linux-musl]
linker = "x86_64-linux-musl-gcc"

代码中检测目标 ​

rust
fn main() {
    // 编译时常量
    println!("目标架构: {}", std::env::consts::ARCH);
    println!("目标操作系统: {}", std::env::consts::OS);
    println!("目标系列: {}", std::env::consts::FAMILY);
    println!("可执行文件后缀: '{}'", std::env::consts::EXE_SUFFIX);
    println!("动态库后缀: '{}'", std::env::consts::DLL_SUFFIX);

    // 条件编译
    #[cfg(target_os = "windows")]
    println!("Windows 平台");

    #[cfg(target_os = "linux")]
    println!("Linux 平台");

    #[cfg(target_arch = "x86_64")]
    println!("x86_64 架构");

    #[cfg(target_arch = "aarch64")]
    println!("ARM64 架构");

    // 指针宽度
    println!("指针宽度: {} 位", std::mem::size_of::<usize>() * 8);
}

基本示例 ​

rust
// 跨平台的路径处理

fn config_dir() -> String {
    #[cfg(windows)]
    {
        std::env::var("APPDATA").unwrap_or_else(|_| "C:\\Users\\Default".to_string())
    }

    #[cfg(target_os = "linux")]
    {
        std::env::var("XDG_CONFIG_HOME")
            .unwrap_or_else(|_| {
                let home = std::env::var("HOME").unwrap_or_else(|_| "/tmp".to_string());
                format!("{}/.config", home)
            })
    }

    #[cfg(target_os = "macos")]
    {
        let home = std::env::var("HOME").unwrap_or_else(|_| "/tmp".to_string());
        format!("{}/Library/Application Support", home)
    }
}

fn main() {
    println!("配置目录: {}", config_dir());
    println!("OS: {}", std::env::consts::OS);
    println!("ARCH: {}", std::env::consts::ARCH);
}

常见问题 ​

问题一:交叉编译需要什么额外工具?

需要目标平台的链接器和系统库。Linux 上用 apt install gcc-aarch64-linux-gnu 安装交叉编译工具链。Windows 到 Linux 可以用 cross 工具(基于 Docker)。

问题二:怎么编译静态链接的二进制文件?

使用 x86_64-unknown-linux-musl 目标,musl libc 会被静态链接,生成的二进制不依赖系统 glibc。需要先 rustup target add x86_64-unknown-linux-musl。

问题三:WebAssembly 目标怎么使用?

安装 wasm32-unknown-unknown 目标后用 cargo build --target wasm32-unknown-unknown 编译。通常配合 wasm-pack 或 wasm-bindgen 工具使用。

问题四:Tier 1/2/3 有什么区别?

Tier 1 保证构建和测试通过(如 x86_64 Windows/Linux/macOS)。Tier 2 保证能构建但不保证测试(如 ARM Linux、WebAssembly)。Tier 3 有代码支持但不保证能构建。

适用场景 ​

  • 交叉编译:为不同平台构建二进制文件
  • 嵌入式开发:编译到 ARM Cortex-M 等嵌入式目标
  • WebAssembly:编译到浏览器或 WASI 运行时
  • 静态链接:使用 musl 目标生成无依赖二进制
  • CI/CD:在一个平台上为多个目标构建

注意事项 ​

  • 交叉编译需要安装目标的标准库和链接器
  • .cargo/config.toml 可以配置默认目标和链接器
  • cross 工具简化了交叉编译环境配置
  • 不是所有 crate 都支持所有目标(特别是有 C 依赖的)
  • no_std crate 可以编译到没有操作系统的嵌入式目标
  • rustup target list 查看所有可用目标

总结 ​

编译目标用目标三元组表示(如 x86_64-unknown-linux-gnu),通过 --target 参数交叉编译到其他平台。rustup target add 安装目标的标准库,.cargo/config.toml 配置默认目标和链接器。代码中用 #[cfg(target_os)]、#[cfg(target_arch)] 等进行条件编译。常见目标包括 Windows MSVC、Linux GNU/musl、macOS、WebAssembly、ARM 嵌入式等。musl 目标生成静态链接二进制,cross 工具简化交叉编译环境配置。