Python配置文件首选JSON、INI、YAML：JSON轻量通用但无注释；INI结构清晰适合简单场景；YAML功能强支持嵌套与注释，推荐中大型项目；应封装Config类统一管理并校验。
Python 中处理配置文件最常用的是 JSON、INI 和 YAML 三种格式，它们各有适用场景：JSON 简洁通用，适合简单结构和跨语言交互；INI 轻量易读，适合传统桌面或小型工具配置；YAML 表达力强、支持嵌套与注释，适合复杂服务配置（如 Docker、CI/CD）。选对格式 + 正确解析方式，能避免硬编码、提升可维护性。
JSON 配置：轻量可靠，内置支持开箱即用
Python 标准库 json 模块无需安装，适合存储键值对、列表、嵌套字典等结构化数据。注意：JSON 不支持注释、单引号、末尾逗号，键名必须是双引号字符串。
- 写入配置：json.dump(data, file, indent=2) 保持可读性，ensure_ascii=False 支持中文输出
- 读取配置：json.load(file) 直接返回 Python 字典，可直接访问 config["database"]["host"]
- 常见问题：路径错误导致 FileNotFoundError；中文乱码多因未指定 encoding="utf-8"；修改后忘记调用 file.seek(0) 和 file.truncate() 就重写文件
INI 配置：类 Windows 风格，section-driven 结构清晰
使用标准库 configparser，天然适配带节（[section]）的扁平化配置，比如日志级别、不同环境参数。不支持嵌套，但语法直观，老项目兼容性好。
- 读取：config.read("config.ini")，再用 config.get("db", "port") 或 config.getint("db", "port") 自动转类型
- 写入：先 config.add_section("cache")，再 config.set("cache", "timeout", "30")，最后 config.write(file)
- 技巧：用 config["DEFAULT"] 定义全局默认值；interpolation=None 可禁用 %()s 变量替换，避免误解析
YAML 配置：灵活强大，推荐用于中大型项目
YAML 需安装第三方库：pip install pyyaml。它支持注释、锚点（&）、引用（*）、多行字符串和复杂数据类型，是现代运维和微服务配置的主流选择。
立即学习“Python免费学习笔记（深入）”；
- 安全加载：yaml.safe_load(file) 替代 yaml.load()，防止反序列化恶意代码
- 保留顺序（Python 3.7+ 默认 dict 有序）：若需显式保障，用 yaml.CLoader 或自定义构造器
- 常见坑：缩进必须用空格（不能用 Tab）；布尔值写成 yes/no 或 on/off 会被自动转 bool；日期字符串可能被误解析为 datetime，可用 yaml.FullLoader 控制
统一管理建议：封装 Config 类，按需切换格式
避免每个模块重复写读取逻辑。可封装一个基础 Config 类，通过文件扩展名自动选择解析器，对外提供统一的 get(key, default=None) 接口。
- 支持热重载：监听文件 mtime 变化，开发时配置修改后自动生效（适合调试）
- 环境隔离：用 os.getenv("ENV", "dev") 动态加载 config.dev.yaml 或 config.prod.json
- 校验机制：配合 pydantic 定义配置 Schema，启动时校验必填项、类型、范围，提前暴露问题
