掌握 Rust 条件编译（深入理解 #[cfg] 属性实现跨平台开发）

什么是 #[cfg] 属性？

#[cfg] 是 Rust 提供的一个编译时属性，用于根据预定义或自定义的“配置选项”决定是否编译某段代码。它不会影响运行时行为，只在编译阶段起作用。

常见的应用场景包括：

• 为不同操作系统（Windows、Linux、macOS）编写特定代码
• 在调试模式和发布模式下启用不同功能
• 根据 CPU 架构（x86_64、ARM）优化性能
• 通过自定义标志控制功能开关（如 feature = "web"）

基本语法

#[cfg(...)] 可以应用于函数、模块、结构体、常量等几乎所有项（item）。其基本形式如下：

#[cfg(target_os = "windows")]fn hello() {    println!("Hello from Windows!");}#[cfg(target_os = "linux")]fn hello() {    println!("Hello from Linux!");}

上面的代码会根据当前编译目标的操作系统，只编译对应的 hello 函数。如果你在 Linux 上编译，只会包含 Linux 版本；在 Windows 上则只包含 Windows 版本。

常用配置选项

Rust 内置了许多预定义的配置选项，以下是一些最常用的：

组合条件：and、or、not

你还可以使用逻辑操作符组合多个条件：

• all(...)：所有条件都为真
• any(...)：任意一个条件为真
• not(...)：条件不成立

// 仅在 Linux 且是 x86_64 架构下编译#[cfg(all(target_os = "linux", target_arch = "x86_64"))]fn optimized_linux_x64() {    println!("Using optimized x86_64 Linux code");}// 在 Windows 或 macOS 下编译#[cfg(any(target_os = "windows", target_os = "macos"))]fn desktop_only() {    println!("Running on desktop OS");}// 非调试模式下启用#[cfg(not(debug_assertions))]const LOG_LEVEL: &str = "warn";

自定义 cfg 标志

除了内置选项，你还可以通过编译器参数或 Cargo.toml 定义自己的标志。

方法一：通过 rustc 命令行

rustc --cfg my_feature main.rs

方法二：在 Cargo.toml 中定义特性（推荐）

# Cargo.toml[features]web = []database = []

然后在代码中使用：

#[cfg(feature = "web")]mod web_server {    pub fn start() {        println!("Web server started");    }}fn main() {    #[cfg(feature = "web")]    web_server::start();}

编译时启用特性：

cargo run --features "web"

实战小例子：跨平台日志路径

下面是一个完整的例子，展示如何根据操作系统设置日志文件路径：

fn get_log_path() -> String {    #[cfg(target_os = "windows")]    {        return r"C:\logs\app.log".to_string();    }    #[cfg(any(target_os = "linux", target_os = "macos"))]    {        return "/var/log/app.log".to_string();    }    #[cfg(not(any(target_os = "windows", target_os = "linux", target_os = "macos")))]    {        // 兜底方案        return "./app.log".to_string();    }}fn main() {    println!("Log file path: {}", get_log_path());}

总结

#[cfg] 属性是 Rust 实现跨平台开发和灵活构建配置的关键工具。通过合理使用内置配置选项、逻辑组合以及自定义特性，你可以编写出高度可移植、可定制的 Rust 程序。无论是处理不同操作系统的 API 差异，还是按需启用高级功能，Rust 条件编译都能让你的代码更加优雅和高效。

记住几个核心要点：

• #[cfg] 是编译期行为，不影响运行时性能
• 善用 all、any、not 组合复杂条件
• Cargo 特性（features）是管理可选功能的最佳实践
• 始终提供兜底方案，避免未定义行为

希望这篇教程能帮助你掌握 Rust #[cfg] 属性 的使用！快去试试为你的项目添加条件编译吧！