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")
- 必须在
read()之前设置optionxform = str，设晚了无效 - 如果只读不写，且确定所有 section 都是小写，可以跳过这步；但只要涉及写入或大小写敏感场景，务必加
- Python 3.2+ 支持
ConfigParser(interpolation=None)，但大小写问题仍需手动处理
修改值后如何安全写回文件，避免覆盖原有注释和空行？
config.write() 不保留注释、空行、原始缩进，它只输出纯结构化内容。如果你的 config.ini 原本有注释如 # timeout in seconds，调用 write() 后就没了。
真实项目中，推荐两种策略：
立即学习“Python免费学习笔记（深入）”；
- 接受无注释：仅用于自动化配置生成（如 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 配置。
