Python配置文件解析：JSONINIYAML实战教程

本文深入解析了Python中JSON、INI和YAML三大主流配置文件格式的实战用法与选型逻辑：JSON轻量通用但不支持注释，适合简单跨语言场景；INI结构清晰、兼容性好，专为扁平化节式配置设计；YAML功能强大、可读性强，支持嵌套、注释与复杂数据类型，是中大型项目和现代运维配置的首选；文章不仅详解各格式的读写技巧、常见坑点（如编码、缩进、安全加载），更强调工程化实践——通过封装统一Config类实现格式自动识别、热重载、环境隔离与Schema校验，真正帮助开发者告别硬编码，构建健壮、可维护、易扩展的配置管理体系。

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。它支持注释、锚点（&）、引用（*）、多行字符串和复杂数据类型，是现代运维和微服务配置的主流选择。

• 安全加载：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，启动时校验必填项、类型、范围，提前暴露问题

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python配置文件解析：JSONINIYAML实战教程》文章吧，也可关注golang学习网公众号了解相关技术文章。