configparser报“File contains no section headers”因INI文件开头无节头或含BOM；大小写敏感需设optionxform=str；非字符串类型需手动转换；多文件合并时同名节会被完全替换而非键值合并。
configparser 读取 ini 文件时为什么会报错“File contains no section headers”
这是最常见的错误，本质是文件开头或节（section）定义不符合 INI 格式规范。configparser 要求每个配置节必须以
形式独占一行，且前面不能有空格或 BOM 字符。
实操建议：
用文本编辑器（如 VS Code、Notepad++）检查文件编码，保存为 UTF-8 无 BOM 格式；
确认第一行不是空行或注释行——INI 文件允许以
或
开头的注释，但**必须在节之后**；
避免 Windows 记事本默认保存的 UTF-8 + BOM，它会在文件开头插入不可见字节，导致 parser 直接拒绝解析；
可先用
检查前几个字节是否含
（BOM）。
如何让 configparser 支持大小写敏感的选项名（option）
默认情况下，configparser 会把所有 option 名转为小写（例如
和
都变成
），这在对接区分大小写的系统（如某些数据库连接参数）时会导致覆盖或丢失。
解决方法是自定义
方法：
立即学习
“
Python免费学习笔记（深入）
”；
注意：
必须在
之前设置；若使用
，也需同步设置该属性。
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
读取布尔值、数字、列表等非字符串类型要自己转换
configparser 只返回字符串，
、
等方法虽存在，但它们有严格限制：
只认
、
、
、
（不区分大小写），其他如
、
会抛
；
遇到空格或单位（如
、
）直接失败；
没有内置的
，像
需手动
并去空格；
推荐封装一层安全读取函数，例如：
防空值。
多个
配置文件
合并时，重复 section 怎么处理
configparser 默认不支持“覆盖式加载”，调用多次
时，后读的文件中同名 section 会**完全替换**前一个（不是合并键值对），容易误丢配置。
安全做法是显式合并：
更关键的是：不要依赖文件读取顺序来“覆盖”，而应在代码里明确哪些配置允许被覆盖、哪些必须保留——否则上线后 local.ini 少写一个 key，就可能让 base.ini 中的关键项彻底消失。
[section_name]#;open('config.ini', 'rb').read(10)b'\xef\xbb\xbf'HostHOSThostoptionxformimport configparser
config = configparser.ConfigParser()
config.optionxform = str # 关键：禁用默认的 str.lower 转换
config.read('config.ini')
optionxformread()ConfigParser(interpolation=None)getboolean()getint()getboolean()yes/notrue/falseon/off1/0enabledYValueErrorgetint()"8080 ""42ms"getlist()ports = 80, 443, 8080split(',')config.get('server', 'timeout', fallback='30').strip() or '30'read()config = configparser.ConfigParser()
config.read(['base.ini', 'local.ini']) # 顺序重要：后者优先
# 或逐个读取并手动 update：
for filename in ['base.ini', 'local.ini']:
temp = configparser.ConfigParser()
temp.read(filename)
for section in temp.sections():
if not config.has_section(section):
config.add_section(section)
for key, value in temp.items(section):
config.set(section, key, value)