Python读取INI文件最稳妥方式是用标准库configparser，需显式设optionxform=str避免大小写转换、allow_no_value=True支持空值、encoding指定编码防乱码，并优先用get()而非下标访问以启用插值。
Python 读取 INI 文件最稳妥的方式就是用标准库的 configparser，它原生支持、无需安装、语法兼容主流 INI 格式，但默认区分大小写且不自动展开变量——这两点最容易出问题。
为什么直接 configparser.ConfigParser() 读不到 key？
因为默认配置下，configparser 把所有 section 名和 option 名都转成小写（optionxform=str.lower），如果你的 INI 里写了 DB_URL，而代码里用 config.get("database", "DB_URL")，会报 NoOptionError——它实际存的是 db_url。
- 解决办法：初始化时关掉自动转换：
ConfigParser(interpolation=None, allow_no_value=True)不够，还得加optionxform=str - 更推荐初始化为：
config = ConfigParser(optionxform=str) - 如果 INI 里有空值（如
debug=），记得设allow_no_value=True，否则解析失败
如何安全读取带环境变量或引用的值（比如 log_path = %(home)s/logs/app.log）？
configparser 默认启用 BasicInterpolation，能处理 %(section:option)s 或 %(option)s 这类引用，但前提是目标 section 存在、option 有值，且不能跨 section 循环引用。
- 禁用插值（避免意外展开）：
ConfigParser(interpolation=None) - 启用插值并允许 fallback：
ConfigParser(interpolation=ExtendedInterpolation())（支持${section:option}和跨节引用） - 读取时用
get()而不是直接取config["section"]["option"]，后者绕过插值逻辑，返回原始字符串
遇到中文乱码或特殊字符报错怎么办？
常见错误是 UnicodeDecodeError: 'gbk' codec can't decode byte...，尤其 Windows 下保存的 INI 文件默认是 GBK 编码，而 Python 3 默认用 UTF-8 打开。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
- 必须显式指定编码：
config.read("config.ini", encoding="utf-8")（如果文件是 UTF-8） - 如果不确定编码，先用
chardet检测，或统一要求配置文件保存为 UTF-8 with BOM（Windows 记事本可选） - 注意：BOM 会被当作文本内容读入，可能导致值开头多出
\ufeff，可用.strip("\ufeff")清理
读取后怎么优雅地转成字典或 Pydantic 模型？
configparser 返回的是嵌套结构，config._sections 是私有属性，别直接用；正确方式是遍历 config.sections() + config.items(section)。
- 转普通字典示例：
conf_dict = {s: dict(config.items(s)) for s in config.sections()} - 给 Pydantic 用时，注意字段名若含短横线（如
api-timeout），需映射为合法属性名（如用alias），否则BaseModel.parse_obj()会失败 - 如果多个 section 共享同名 option（如都叫
timeout），手动合并时得加前缀，不然会覆盖
真正麻烦的从来不是读取动作本身，而是 INI 文件由不同人维护、编码不统一、插值嵌套过深、或者选项名大小写混用——这些细节不会报语法错误，但会让 get() 返回意料之外的值，调试时得一层层 print config.items("section") 看真实键名。
