configparser读取ini文件报NoSectionError等错误，主因是路径/编码错误、节名含空格或BOM、未校验sections()、类型转换前未清洗值、多环境需手动切换section、新版对无节文件更严格，建议显式关闭插值并预检文件内容。
configparser 读取 ini 文件时找不到节（NoSectionError）
常见于配置文件路径不对、编码不匹配，或节名带空格/不可见字符。Python 的 configparser 默认区分大小写，且不自动 strip 节名前后空白。
- 先用
open(config_path, encoding="utf-8-sig")手动打开文件确认内容可读，避免 BOM 或乱码干扰 - 检查
.ini文件是否以 [section_name] 开头，不能是 [section_name]（含空格）或 [section_name] 后跟中文注释（某些旧版 Python 会卡在注释上） - 调用
config.read()后，立刻打印config.sections()看实际加载了哪些节——别假设文件一定被读进去了
getint() / getfloat() 报 ValueError：值不是合法数字
ini 文件里数值字段如果带空格、单位、注释或默认值未设，getint() 会直接炸，而不是返回 fallback。
- 不要依赖
fallback参数绕过类型校验：config.getint("db", "port", fallback=5432)仍会在原始值为" 5432 "或"5432#主库"时失败 - 安全做法是先
config.get("db", "port")拿字符串，再手动strip()+split("#")[0]清洗，最后int() - 若配置项允许为空，务必加
if config.has_option("db", "port"):判断，否则get()本身也会抛NoOptionError
多环境配置（dev/test/prod）怎么共用一份 ini 文件
configparser 本身不支持“环境切换”，得靠代码组织逻辑，不是靠语法糖。
- 推荐结构：每个环境一个 section，如 [
dev]、[prod]，用环境变量决定读哪个：env = os.getenv("ENV", "dev")，再config["dev"]或config[env] - 避免用
config.read_dict()合并多个 section——它不会覆盖重复 key，而是静默忽略后读的值 - 注意 interpolation（默认开启）：若 prod 里写
host = %(base_host)s-db，就得确保base_host在同一 section 或 DEFAULT 里定义，否则报InterpolationMissingOptionError
configparser 在 Python 3.12+ 里读取无 section 的 ini 文件失败
新版更严格：空文件、纯注释文件、或没 [section] 的文件，read() 返回空列表，且后续访问直接报错。
立即学习“Python免费学习笔记（深入）”；
- 最简兜底：在
read()后加if not config.sections(): raise ValueError("config file has no valid section") - 若真需要“无节”键值对（比如 shell 风格的
KEY=VALUE），别硬用 configparser——改用pathlib.Path(config_path).read_text().splitlines()自行解析更稳 - 兼容老项目？在
ConfigParser()初始化时显式关掉插值：ConfigParser(interpolation=None)，能少踩一半坑
ini 文件看着简单，但 configparser 对格式、编码、空格、插值都敏感，出问题往往不是代码写错了，而是配置文件里藏着一个看不见的换行或 BOM。
