ConfigParser默认section名大小写敏感;修改后需显式write()才保存;set()前须add_section();读取数值/布尔值需用getint()/getboolean()等方法;value首尾空格会被保留。

ConfigParser 读取 ini 文件时 Section 名字区分大小写吗
默认区分,ConfigParser 的 section 名是大小写敏感的——哪怕你写的是 [Database] 和 [database],它会当成两个不同 section 处理。
常见错误现象:代码里用 config.has_section("database") 返回 False,但 ini 文件里明明写了 [database];结果发现实际文件里是 [Database],首字母大写了。
实操建议:
- 如果想统一忽略大小写,初始化时传入 interpolation=None 并重载 optionxform 方法(但更推荐直接改配置习惯)
- 更稳妥的做法是:用 config.sections() 打印出所有真实 section 名,对照确认
- 不要依赖“肉眼看起来一样”,用 repr(section_name) 看是否含空格或不可见字符
用 ConfigParser 写入键值后为什么 ini 文件没更新
因为 ConfigParser 是内存操作,读进来、改完、必须显式调用 write() 才会落盘。
常见错误现象:执行了 config.set("log", "level", "DEBUG"),但打开 ini 文件发现没变;或者程序退出后配置还原。
立即学习“Python免费学习笔记(深入)”;
实操建议:
- 写入后一定要配对使用 with open("config.ini", "w") as f: config.write(f)
- 注意打开模式必须是 "w",不是 "a",否则会乱码或重复写入
- 如果用 config.read("config.ini") 读取后立刻 set 再 write,确保路径一致,别读 A 文件、写 B 文件
- Windows 下注意换行符:默认用 \n,若需兼容记事本,可加 newline="" 参数到 open()
ConfigParser set() 报错 “No section: 'xxx'” 怎么办
说明目标 section 还不存在,set() 不会自动创建 section,只负责设键值。
使用场景:动态生成配置、运行时添加新模块配置项。
实操建议:
- 先用 config.add_section("xxx"),再 config.set("xxx", "key", "value")
- 如果不确定是否存在,用 if not config.has_section("xxx"): config.add_section("xxx")
- 别在 add_section() 里传空字符串或只含空格的字符串,会抛 ValueError
- 注意 section 名不能包含 [、]、;、# 等特殊字符,否则解析失败
ConfigParser 读取布尔值或数字总返回字符串怎么办
它天生只认字符串,get() 系列方法不会自动类型转换,连 True、1、yes 都当普通文本返回。
性能影响:自己转类型开销极小,不用怕;但反复写 int(config.get("db", "port")) 容易漏异常。
实操建议:
- 用 getint()、getfloat()、getboolean() 替代 get(),它们内部做了转换和校验
- getboolean() 只认 1/0、yes/no、true/false、on/off(不区分大小写)
- 如果值可能为空或缺失,优先用 get(..., fallback=...),避免 NoOptionError
- 自定义类型(如列表、JSON)别硬塞进 ini,该换 toml 或 json 就换,ini 不是万能容器
真正容易被忽略的是:ini 文件里 value 开头或结尾的空格会被保留,get() 返回的字符串自带这些空格;如果用来拼接路径或比较开关状态,不 .strip() 就可能出问题。










