Python配置文件操作教程_JSONINIYAML解析与应用实战

2026-01-01 00:00:00 作者：舞夢輝影

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

安全加载：yaml.safe_load(file) 替代 yaml.load()，防止反序列化恶意代码
保留顺序（Python 3.7+ 默认 dict 有序）：若需显式保障，用 yaml.CLoader 或自定义构造器
常见坑：缩进必须用空格（不能用 Tab）；布尔值写成 yes/no 或 on/off 会被自动转 bool；日期字符串可能被误解析为 datetime，可用 yaml.FullLoader 控制