编译目标 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 保证可以构建和通过测试。
# 查看当前主机目标
# 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-msvc | Windows 64位 MSVC |
x86_64-pc-windows-gnu | Windows 64位 MinGW |
x86_64-unknown-linux-gnu | Linux 64位 GNU |
x86_64-unknown-linux-musl | Linux 64位 musl(静态链接) |
aarch64-unknown-linux-gnu | Linux ARM64 |
x86_64-apple-darwin | macOS Intel |
aarch64-apple-darwin | macOS Apple Silicon |
wasm32-unknown-unknown | WebAssembly |
wasm32-wasip1 | WebAssembly WASI |
aarch64-linux-android | Android ARM64 |
aarch64-apple-ios | iOS ARM64 |
thumbv7em-none-eabihf | ARM 嵌入式(无OS) |
配置默认目标
# .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"代码中检测目标
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);
}基本示例
// 跨平台的路径处理
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_stdcrate 可以编译到没有操作系统的嵌入式目标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 工具简化交叉编译环境配置。