configparser 默认将 section 和 option 名转为小写,需设 optionxform = str 保留原始大小写;写入时 config.write() 不保留注释和空行;新增选项前须先 add_section();多环境配置可通过顺序读取多个文件实现覆盖。

用 configparser 读取 INI 文件时,为什么 section 名会自动转小写?
默认情况下,ConfigParser 会把所有 section 名和 option 名转成小写,这是它的默认行为,不是 bug。如果你的 INI 文件里写了 [Database],读出来变成 database,后续用 config.has_section("Database") 就会返回 False。
解决方法是禁用大小写转换:
from configparser import ConfigParser
<p>config = ConfigParser()
config.optionxform = str # 关键:保留原始大小写
config.read("config.ini")
</p>
- 必须在
read()之前设置optionxform = str,设晚了无效 - 如果只读不写,且确定所有 section 都是小写,可以跳过这步;但只要涉及写入或大小写敏感场景,务必加
- Python 3.2+ 支持
ConfigParser(interpolation=None),但大小写问题仍需手动处理
修改值后如何安全写回文件,避免覆盖原有注释和空行?
config.write() 不保留注释、空行、原始缩进,它只输出纯结构化内容。如果你的 config.ini 原本有注释如 # timeout in seconds,调用 write() 后就没了。
真实项目中,推荐两种策略:
- 接受无注释:仅用于自动化配置生成(如 CI 环境),直接用
config.write(open("config.ini", "w")) - 保留格式:改用
configparser.RawConfigParser+ 手动拼接,或换用第三方库如configobj(支持注释保留) - 折中方案:把用户可编辑部分(如
[user])和程序自动生成部分(如[generated])拆到不同文件,只对后者用write()
写入新 section 或 option 时,set() 报错 NoSectionError 怎么办?
config.set(section, option, value) 要求 section 必须已存在,否则抛 NoSectionError。不能靠 set() 自动创建 section。
正确流程是分两步:
if not config.has_section("Logging"):
config.add_section("Logging")
config.set("Logging", "level", "DEBUG")
-
add_section()不能带=,也不能重复添加,否则报DuplicateSectionError -
set()的value必须是字符串;传int或bool会报TypeError - 想批量写入字典?得遍历:
for k, v in my_dict.items(): config.set("Section", k, str(v))
多环境配置(dev/test/prod)怎么用同一份代码切换?
INI 本身不支持“继承”或“环境变量插值”,但可以用组合方式模拟:
- 主配置
base.ini放通用项,各环境文件(dev.ini、prod.ini)只写差异项 - 用
config.read([base_file, env_file])顺序读取,后读的覆盖前读的同名 key - 注意:覆盖只发生在相同 section+option,不会自动合并 list 或 dict 类型值
- 如果需要运行时替换变量(如
host = ${DB_HOST}),启用插值:ConfigParser(interpolation=BasicInterpolation()),但要确保环境变量已注入os.environ
最常被忽略的是路径加载顺序——read() 返回的是成功加载的文件列表,如果某个环境文件路径错或权限不足,它会静默跳过,导致你以为切到了 prod,实际还在用 base 配置。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











