Rust / 系统课时
读取环境变量
读取环境变量
环境变量常用于传入运行模式、密钥和路径。本课用一个完整程序读取文本变量、当前工作目录与操作系统原生字符串,并在配置缺失或内容不是 Unicode 时给出明确错误。
学习目标
- 使用
std::env读取环境变量和当前目录 - 为可选配置提供默认值,为必需配置返回错误
- 正确处理可能包含非 Unicode 字节的路径变量
读取文本变量与当前目录
env::var 适合读取确定为 UTF-8 文本的配置,返回类型是 Result<String, VarError>。env::current_dir 返回 PathBuf,但当前目录可能因权限、目录被删除等原因读取失败,因此不要直接 unwrap。
下面的程序将 APP_MODE 视为可选配置,将 API_TOKEN 视为必需配置,并允许 DATA_DIR 保留操作系统原生编码。
use std::env::{self, VarError};
use std::path::PathBuf;
use std::process::ExitCode;
fn main() -> ExitCode {
let current_dir = match env::current_dir() {
Ok(path) => path,
Err(error) => {
eprintln!("无法读取当前目录: {error}");
return ExitCode::from(1);
}
};
// 可选配置只有在缺失时才使用默认值
let app_mode = match env::var("APP_MODE") {
Ok(value) => value,
Err(VarError::NotPresent) => "development".to_string(),
Err(VarError::NotUnicode(_)) => {
eprintln!("APP_MODE 不是有效 UTF-8 文本");
return ExitCode::from(2);
}
};
let api_token = match env::var("API_TOKEN") {
Ok(value) if !value.is_empty() => value,
Ok(_) | Err(VarError::NotPresent) => {
eprintln!("缺少必需环境变量 API_TOKEN");
return ExitCode::from(3);
}
Err(VarError::NotUnicode(_)) => {
eprintln!("API_TOKEN 不是有效 UTF-8 文本");
return ExitCode::from(4);
}
};
// 路径可能不是 Unicode,优先使用 var_os 与 PathBuf
let data_dir = env::var_os("DATA_DIR")
.map(PathBuf::from)
.unwrap_or_else(|| current_dir.clone());
println!("current_dir={}", current_dir.display());
println!("app_mode={app_mode}");
println!("data_dir={}", data_dir.display());
println!("token_length={}", api_token.len());
ExitCode::SUCCESS
}在 Linux 或 macOS 中设置变量并运行:
APP_MODE=production API_TOKEN=demo-token DATA_DIR=/tmp/anystack cargo run --quiet预期输出如下,<PATH> 代表实际项目目录:
current_dir=<PATH>
app_mode=production
data_dir=/tmp/anystack
token_length=10区分缺失配置与非法文本
VarError::NotPresent 表示变量不存在,适合触发默认值或“缺少配置”错误。VarError::NotUnicode 表示变量存在,但不能转换成 Rust 的 String;对密钥、模式等文本配置应直接拒绝,而不是悄悄替换字符。
路径变量更适合使用 env::var_os。它返回 Option<OsString>,不会强制转换成 UTF-8。示例中的 PathBuf::from 可以继续安全地参与路径拼接、文件访问和存在性检查。
配置处理边界
空字符串不一定等于缺失。示例将空的 API_TOKEN 当作错误,因为空密钥没有业务意义;对于允许为空的变量,应单独定义规则。打印路径时使用 display() 只是为了展示,实际文件操作仍应保留 PathBuf,不要把展示字符串再转换回路径。
环境变量属于进程级输入。程序启动后读取到的是当前进程环境,不要把密钥完整写入日志,也不要依赖运行期间由其他进程修改环境变量。
本课总结
- 文本配置使用
env::var,并区分缺失与非 Unicode 两类错误 - 路径等原生值使用
env::var_os和PathBuf,避免不必要的 UTF-8 转换 - 当前目录和必需配置都可能失败,应返回明确退出码而不是直接崩溃
下一课预告
下一课将使用 Command 启动外部程序,并同时读取退出状态、标准输出和错误输出。