configparser读取ini文件报“File not found”主因是路径错误或工作目录不符;read()不抛异常而返回空列表,需用os.path.exists()验证并推荐绝对路径;section名禁用空格等特殊字符;值默认为字符串,应使用getint()等方法转换;跨平台路径统一用正斜杠,避免隐式依赖。

configparser 读取 ini 文件时为什么报错“File not found”
常见原因是路径写错,或者当前工作目录和预期不一致。Python 的 configparser.ConfigParser().read() 不会抛出异常提示文件不存在,而是静默失败——它只返回一个空列表,后续调用 get() 就会触发 NoSectionError 或 NoOptionError。
- 先用
os.path.exists()检查路径是否真实存在,比如os.path.exists("config.ini") - 推荐用绝对路径:用
os.path.join(os.path.dirname(__file__), "config.ini")替代相对路径 -
read()返回的是成功加载的文件路径列表,打印它能快速确认是否真读进去了:print(parser.read(...))
section 名带空格或特殊字符时解析失败
ini 文件里 section 名默认不能含空格、冒号、方括号等,否则 configparser 会跳过整段或报 ParsingError。这不是 bug,是规范限制。
- 合法 section 名只能是字母、数字、下划线、中划线,且不能以数字开头(例如
[db_config]✅,[db config]❌) - 如果必须用空格,得启用兼容模式:
ConfigParser(allow_no_value=True, strict=False)(仅限 Python 3.2+),但仍有风险 - 更稳妥的做法是统一用下划线替代空格,并在文档里约定好命名规则
读取到的值全是字符串,怎么自动转成 int/bool/list
configparser 所有值默认都是字符串,没有类型推断。直接 int(parser.get("section", "port")) 看似简单,但一旦配置写成 port = 8080a 就崩溃。
- 用
getint()/getboolean()/getfloat()替代get(),它们自带校验和转换 -
getboolean()只认yes/no、true/false、on/off、1/0(大小写不敏感),其他值会抛ValueError - list 类型需手动拆分:比如
hosts = 192.168.1.1,192.168.1.2→[h.strip() for h in parser.get("net", "hosts").split(",")]
Windows 和 Linux 下路径分隔符导致配置项读取异常
ini 文件本身不涉及路径拼接,但如果你把路径写在配置里(比如 log_path = ./logs/app.log),跨平台时容易出问题——尤其当代码里又用 os.path.join() 套一层,可能生成 ./logs\app.log 这种混合分隔符。
立即学习“Python免费学习笔记(深入)”;
- 配置项里统一用正斜杠
/,Python 在所有系统都能识别(open("a/b/c.txt")没问题) - 读出来后立刻用
pathlib.Path()处理,比拼接字符串更安全:Path(parser.get("paths", "log_path")) - 避免在配置里写
..,相对路径行为依赖当前工作目录,极难调试
read() 的返回值和 getboolean() 的可接受值范围——这两个点卡住的人最多。










