Rust应用程序配置：config、envy和dotenvy库

Rust应用程序配置：config、envy和dotenvy库

在开发Rust应用程序时，配置管理是一项关键任务。正确的设置加载方法决定了应用程序的灵活性、安全性和部署便利性。在Rust生态系统中，有多个成熟的解决方案可以从文件、环境变量和其他来源读取配置。本文将介绍三种流行的工具：config、envy和dotenvy。

1. config库——通用配置管理器

config是一个强大的库，用于加载分层配置。它支持多种格式（JSON、TOML、YAML、HJSON、INI），以及环境变量和远程源。其核心思想是将所有源合并到一个统一的配置树中。

安装

[dependencies]config = "0.14"serde = { version = "1.0", features = ["derive"] }

使用示例

use config::{Config, File, Environment};use serde::Deserialize;

#[derive(Debug, Deserialize)]struct AppConfig {    server: ServerConfig,    database: DatabaseConfig,}

#[derive(Debug, Deserialize)]struct ServerConfig {    host: String,    port: u16,}

#[derive(Debug, Deserialize)]struct DatabaseConfig {    url: String,    pool_size: u32,}

fn load_config() -> Result<AppConfig, config::ConfigError> {    let cfg = Config::builder()        .add_source(File::with_name("config/default"))  // 基础设置        .add_source(File::with_name("config/local").required(false)) // 本地覆盖        .add_source(Environment::with_prefix("APP")) // 带有前缀APP_的环境变量        .build()?;

    cfg.try_deserialize()}

fn main() {    match load_config() {        Ok(config) => println!("Loaded config: {:?}", config),        Err(e) => eprintln!("Config error: {}", e),    }}

该库会自动合并源：后续源中的值会覆盖前面的值。这使得可以轻松组织层次结构：默认 → 环境 → 本地覆盖。

2. envy库——从环境变量获取配置

envy是一个极简的库，专门从环境变量加载配置。非常适合12-factor应用程序，其中设置应与代码分离。

安装

[dependencies]envy = "0.4"serde = { version = "1.0", features = ["derive"] }

使用示例

use serde::Deserialize;

#[derive(Debug, Deserialize)]struct AppConfig {    #[serde(rename = "SERVER_HOST")]    host: String,    #[serde(rename = "SERVER_PORT")]    port: u16,    #[serde(rename = "DATABASE_URL")]    db_url: String,}

fn load_config() -> Result<AppConfig, envy::Error> {    envy::from_env::<AppConfig>()}

fn main() {    match load_config() {        Ok(config) => println!("Env config: {:?}", config),        Err(e) => eprintln!("Envy error: {}", e),    }}

只需设置环境变量即可使用：

export SERVER_HOST=127.0.0.1export SERVER_PORT=8080export DATABASE_URL=postgres://user:pass@localhost/db

envy支持通过分隔符（例如DATABASE__HOST）实现嵌套结构，以及带有默认值的可选字段。

3. dotenvy库——加载.env文件

dotenvy是流行库dotenv的一个分支，用于从.env文件加载环境变量。在开发过程中特别有用，当需要快速设置本地配置时。

安装

[dependencies]dotenvy = "0.15"<