如何在Python中用configparser解析带节的配置文件？-Python教程-PHP中文网

configparser默认不区分大小写、不保留空格、禁止重复节名，常见问题包括nosectionerror（因bom、空行或节名空格）、大小写混淆及duplicatesectionerror；解决需转utf-8无bom、strip节名、自定义casesensitiveconfigparser、预处理重复节或换用toml/yaml。

如何在python中用configparser解析带节的配置文件？

直接用 configparser.ConfigParser() 就能读带节（section）的配置文件，但默认不区分大小写、不保留空格、遇到重复节名会报错——这些是实际项目里最常踩的坑。

为什么读不到 section 或提示 NoSectionError？

常见原因是配置文件开头有 UTF-8 BOM 或空行/注释被误判为内容起始；也可能是节名写了空格（如 [database ]），而默认解析器会严格匹配字符串（包括末尾空格）。

用文本编辑器确认文件编码是 UTF-8 无 BOM（Notepad++ → 编码 → 转为 UTF-8 无 BOM）
检查节名前后是否有多余空格，建议统一用 strip() 处理后比对：
```
config.sections()  # 看实际读到哪些节名
```
确保配置文件以标准节格式开头，不能在第一个 [section] 前有非空、非注释行

如何让节名和选项名区分大小写？

默认 ConfigParser 对节名和选项名都忽略大小写，导致 [DB] 和 [db] 被视为同一节。要严格区分，必须自定义类并重写 _section_name 和 optionxform：

Python Testing

Python 测试速查：运行 pytest、使用 mock/patch、参数化、fixtures、异步、覆盖率测试。

下载

class CaseSensitiveConfigParser(configparser.ConfigParser):
    def __init__(self):
        super().__init__()
        self.optionxform = str  # 保持选项名原样（不转小写）
<p>config = CaseSensitiveConfigParser()
config.read('config.ini')</p>

注意：节名本身仍需通过继承 _section_name 才能完全保留大小写，但多数场景只需选项名区分就够了。

读取时跳过重复节名或合并同名节？

ConfigParser 默认不允许重复节名，遇到就抛 DuplicateSectionError。如果配置生成逻辑不可控（比如模板拼接出多个 [log]），有两个实用办法：

预处理文件：用 Python 先按行扫描，把后续同名节改写成 [log_2]、[log_3] 再加载
换用 configparser.ExtendedInterpolation() 不解决重复节问题，但可配合 read_file() + 自定义迭代器跳过或聚合
更轻量做法：用 configparser.RawConfigParser() + 手动分段解析（适合结构简单、节名固定的情况）

真正麻烦的是混合了大小写敏感、BOM、重复节、变量插值的配置文件——这种别硬扛，默认解析器不是为鲁棒性设计的，该切到 toml 或 yaml 就切，尤其当团队里有人用 Windows 记事本保存 ini 文件时。