4. 环境变量与命令行参数优先级

优先级链与覆盖判定

配置来源按优先级从高到低排列：命令行参数 > 环境变量 > 配置文件 > 默认值。解析时逐层向上覆盖，最终生效值取最高优先级中实际出现的那个。关键点在于：只有“显式提供”的来源才参与覆盖，未提供的来源不产生任何影响。

实现解析器

下面用 Python 实现一个最小可运行的优先级解析器。核心思路：按优先级从低到高依次合并，高优先级来源覆盖低优先级来源的同名键。

import os
import json
import argparse

DEFAULTS = {"host": "0.0.0.0", "port": 5000, "debug": False}

def load_config_file(path):
    """从 JSON 文件加载配置，文件不存在时返回空字典"""
    if not path or not os.path.isfile(path):
        return {}
    with open(path, "r", encoding="utf-8") as f:
        return json.load(f)

def load_env_vars(prefix="APP_"):
    """从环境变量加载配置，键名去掉前缀并转小写"""
    result = {}
    for key, value in os.environ.items():
        if key.startswith(prefix):
            clean_key = key[len(prefix):].lower()
            result[clean_key] = value
    return result

def parse_cli_args():
    """解析命令行参数，只返回用户显式提供的选项"""
    parser = argparse.ArgumentParser()
    parser.add_argument("--host", type=str, default=None)
    parser.add_argument("--port", type=int, default=None)
    parser.add_argument("--debug", action="store_true", default=None)
    parser.add_argument("--config", type=str, default="config.json")
    args = parser.parse_args()
    # 过滤掉 None 值，只保留显式提供的参数
    cli = {k: v for k, v in vars(args).items() if v is not None and k != "config"}
    return cli, args.config

def resolve_config():
    """按优先级合并：默认值 → 配置文件 → 环境变量 → 命令行参数"""
    cli, config_path = parse_cli_args()

    # 第1层：默认值
    merged = dict(DEFAULTS)

    # 第2层：配置文件覆盖默认值
    file_cfg = load_config_file(config_path)
    merged.update(file_cfg)

    # 第3层：环境变量覆盖配置文件
    env_cfg = load_env_vars()
    merged.update(env_cfg)

    # 第4层：命令行参数覆盖环境变量
    merged.update(cli)

    return merged

if __name__ == "__main__":
    config = resolve_config()
    print(json.dumps(config, indent=2, ensure_ascii=False))

验证覆盖逻辑

准备一个配置文件 config.json：

{"host": "localhost", "port": 3000, "debug": false}

然后按不同来源组合执行，观察输出变化：