在Rust中，--cfg（configuration）标志用于根据条件编译代码。你可以通过在代码中使用条件编译属性来设置这些条件。下面是一些使用 --cfg 的基本步骤：

  1. 在 Cargo.toml 中设置条件：

    在你的 Cargo.toml 文件中，你可以定义一些配置项，这些配置项可以在代码中使用。例如：

    [package]
name = "your_project"
version = "0.1.0"

[features]
# 定义一个名为 "example_feature" 的 feature
example_feature = []

  2. 在代码中使用 --cfg：

    在你的 Rust 代码中，你可以使用 #[cfg] 属性来根据配置项选择性地编译代码块。例如：

    // 只有当 "example_feature" 被启用时才编译这个代码块
#[cfg(feature = "example_feature")]
fn example_function() {
    println!("This code is included when 'example_feature' is enabled");
}

// 当 "example_feature" 被禁用时，这个代码块会被编译
#[cfg(not(feature = "example_feature"))]
fn example_function() {
    println!("This code is included when 'example_feature' is disabled");
}

fn main() {
    // 调用条件编译的函数
    example_function();
}

  3. 使用 --cfg 编译：

    在终端中，通过在 rustc 命令中使用 --cfg 标志来启用或禁用配置项。例如：

    # 启用 "example_feature"(这里比较恶心，必须这样写)
rustc --cfg 'feature="example_feature"' your_code.rs

# 或者在 Cargo 中使用
cargo build --features "example_feature"

    这会告诉编译器根据配置项进行条件编译。

请注意，--cfg 的语法是 feature="your_feature"，其中 your_feature 是在 Cargo.toml 中定义的配置项名称。

在Rust中，--cfg 用于启用或禁用配置项，而这些配置项可以在代码中通过 #[cfg] 属性来使用。

除了用户自定义的配置项外，Rust 也有一些保留属性，它们可以用于条件编译。以下是一些常见的保留属性：

  1. target_os：

    • 根据目标操作系统进行条件编译。
    • 例如，#[cfg(target_os = "windows")] 用于在 Windows 操作系统上条件编译代码。

  2. target_arch：

    • 根据目标处理器架构进行条件编译。
    • 例如，#[cfg(target_arch = "x86_64")] 用于在 x86_64 架构上条件编译代码。

  3. target_pointer_width：

    • 根据目标指针宽度进行条件编译。
    • 例如，#[cfg(target_pointer_width = "64")] 用于在目标指针宽度为 64 位时条件编译代码。

  4. target_feature：

    • 根据目标 CPU 特性进行条件编译。
    • 例如，#[cfg(target_feature = "sse2")] 用于在支持 SSE2 指令集的 CPU 上条件编译代码。

  5. unix 和 windows：

    • #[cfg(unix)] 和 #[cfg(windows)] 用于分别在类 UNIX 和 Windows 系统上条件编译代码。

  6. debug_assertions 和 ndebug：

    • #[cfg(debug_assertions)] 和 #[cfg(not(debug_assertions))] 用于在 debug 模式和 release 模式下条件编译代码。

  7. feature：

    • #[cfg(feature = "your_feature")] 用于根据 Cargo.toml 中的特性进行条件编译。

这些保留属性使得可以根据目标平台、系统特性、编译模式等因素进行灵活的条件编译。