[!info] 关联笔记

• 所属 MOC：系统与服务 · 学习路线
• 前置概念：Serde、clap、错误
• 后续概念：Docker、HTTP
• 容易混淆：CLI 参数

Rust 配置管理

这个概念为什么出现

服务配置来源多：默认、文件、环境变量、命令行。
需要合并顺序、类型校验与密钥不进仓库。

[!abstract] 一句话理解 用强类型 Config 结构体承载配置；按“默认 < 文件 < 环境变量 < CLI”覆盖；启动失败要快且信息明确。

最小可运行示例

场景：读取端口与模式

use std::env;

// 业务意图：环境变量覆盖默认端口。
// 教学点：强类型解析；默认值；错误提前。

#[derive(Debug)]
struct Config {
    port: u16,
    mode: String,
}

impl Config {
    fn from_env() -> Result<Self, String> {
        let port = env::var("APP_PORT")
            .unwrap_or_else(|_| "8080".into())
            .parse()
            .map_err(|e| format!("APP_PORT: {e}"))?;
        let mode = env::var("APP_MODE").unwrap_or_else(|_| "dev".into());
        Ok(Self { port, mode })
    }
}

fn main() {
    let cfg = Config::from_env().expect("config");
    println!("{cfg:?}");
}

建议运行：APP_PORT=3000 cargo run

结合场景再看三个关注点

1. 错误在启动期暴露
2. 密钥只来自环境/密管
3. 可用 config crate 做分层合并

工程实践

1. 示例 .env.example 无秘密
2. 校验枚举模式
3. 配置热更新慎用
4. 与十二因子对齐

本节总结

• 强类型配置
• 覆盖顺序
• 启动失败快速

自测题

1. 为什么配置解析失败应阻止启动？
2. CLI 与环境变量谁优先？

参考答案

1. 避免带错误配置半运行。
2. 通常 CLI 最高，团队写清即可。

延伸阅读与资料来源

资料	类型	支撑内容
12-factor config	方法论	配置
config crate	生态	分层配置