如何在Rust中读取config.toml并支持命令行配置覆盖？

以下是满足需求的具体实现方案，核心思路是命令行参数优先级高于配置文件默认值，借助成熟的 Rust 生态 crate 简化开发：

步骤1：添加依赖 #

在Cargo.toml中引入处理命令行、配置文件的依赖：

[package]
name = "config-demo"
version = "0.1.0"
edition = "2021"

[dependencies]
clap = { version = "4.0", features = ["derive", "env"] }
config = "0.13"
serde = { version = "1.0", features = ["derive"] }
toml = "0.8"

步骤2：编写配置文件config.toml #

按需求存入默认值：

[env]
FOO = "BAR"

步骤3：实现核心逻辑main.rs #

通过config加载配置文件，用clap解析命令行参数，最终合并出优先级最高的配置：

use clap::Parser;
use config::{Config, File};
use serde::Deserialize;

// 对应config.toml中的[env]段
#[derive(Debug, Deserialize, Clone)]
struct EnvConfig {
    foo: String,
}

// 定义命令行参数结构
#[derive(Debug, Parser)]
struct Cli {
    // 支持--config传入KEY=VALUE格式的配置，覆盖默认值
    #[arg(short, long)]
    config: Option<Vec<String>>,
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 1. 加载配置文件默认值
    let mut settings = Config::default();
    settings.merge(File::with_name("config.toml"))?;
    let mut env_config: EnvConfig = settings.get("env")?;

    // 2. 解析命令行参数
    let cli = Cli::parse();

    // 3. 处理命令行配置，覆盖默认值
    if let Some(config_pairs) = cli.config {
        for pair in config_pairs {
            let parts: Vec<&str> = pair.splitn(2, '=').collect();
            if parts.len() != 2 {
                eprintln!("无效配置格式：{}，请使用KEY=VALUE", pair);
                continue;
            }
            let key = parts[0].to_lowercase();
            let value = parts[1].trim_matches('"');
            match key.as_str() {
                "foo" => env_config.foo = value.to_string(),
                _ => eprintln!("未知配置键：{}", key),
            }
        }
    }

    // 4. 读取最终配置值
    let a = env_config.foo;
    println!("最终FOO的值：{}", a);

    Ok(())
}

运行测试 #

• 默认加载配置文件：

  cargo run
  

  输出：最终FOO的值：BAR

• 命令行参数覆盖默认值：

  cargo run -- --config FOO="BAZZ"
  

  输出：最终FOO的值：BAZZ

关键说明 #

• 优先级规则：命令行传入配置 > 配置文件默认值
• 如需新增配置项，只需在EnvConfig中添加对应字段，并在命令行处理逻辑中匹配新的key即可
• 代码包含基础格式校验，避免无效配置输入

内容的提问来源于stack exchange，提问作者Pap113