首次使用configparser遇NoOptionError：DEFAULT无inputpath选项

问题现象 #

• 已生成格式正确的config.ini文件，文件存在且内容正常
• 读取配置时sections()返回空列表，无法获取配置项
• 调用config.get('DEFAULT', 'inputpath')触发configparser.NoOptionError: No option 'inputpath' in section: 'DEFAULT'
• 删除文件则触发FileNotFoundError

生成的config.ini内容 #

[DEFAULT]
inputpath = Test Line 1
outputpath = Test Line 2
filename = Test Line 3

原始测试代码 #

import os
import configparser


config = configparser.ConfigParser()

# 写入配置文件（已注释）
# config['DEFAULT']['inputpath'] = 'Test Line 1'
# config['DEFAULT']['outputpath'] = 'Test Line 2'
# config['DEFAULT']['filename'] = 'Test Line 3'
# with open('config.ini', 'w') as configfile:
#    config.write(configfile)

if os.path.exists('config.ini'):
    print('The path exists')
else:
     print('The path does not exist')

print("Check Before")
with open("config.ini", "r") as cfile:
    for line in cfile.readlines():
        print(line)
print("Check After")

print('Sections:')
print(config.sections())

with open("config.ini", "r") as configfile:
    config.read(configfile)  # 错误用法

inputpath_default = config.get('DEFAULT', 'inputpath')
print('inputpath_default: ' + inputpath_default)
outputpath_default = config.get('DEFAULT', 'outputpath')
print('outputpath_default: ' + outputpath_default)
filename_default = config.get('DEFAULT', 'filename')
print('filename_default: ' + filename_default)

print('Done')

exit()

报错输出 #

The path exists
Check Before
[DEFAULT]

inputpath = Test Line 1

outputpath = Test Line 2

filename = Test Line 3



Check After
Sections:
[]
Traceback (most recent call last):
...
  File "/Users/xxxxxx/Config.py", line 31, in <module>
    inputpath_default = config.get('DEFAULT', 'inputpath')
  File "/Library/Frameworks/Python.framework/Versions/3.13/lib/python3.13/configparser.py", line 821, in get
    raise NoOptionError(option, section)
configparser.NoOptionError: No option 'inputpath' in section: 'DEFAULT'

错误原因 #

代码中使用config.read(configfile)时传入了已打开的文件对象，但configparser.ConfigParser.read()方法的参数是文件路径字符串（或路径列表），不是文件对象。传入文件对象会导致配置无法正确加载，因此sections()返回空，也无法读取到DEFAULT中的配置项。

修正方案 #

有两种正确的读取方式：

方式1：使用read()传入文件路径（推荐） #

直接传入文件路径字符串，read()方法会自动处理文件的打开和关闭，还能避免文件对象操作的问题：

# 替换原读取代码块
print('Sections:')
# 直接传入路径，无需手动打开文件
config.read('config.ini')
# DEFAULT是特殊section，sections()不会返回它，但可以直接获取配置项
print("All sections (excluding DEFAULT):", config.sections())

inputpath_default = config.get('DEFAULT', 'inputpath')
print('inputpath_default: ' + inputpath_default)
outputpath_default = config.get('DEFAULT', 'outputpath')
print('outputpath_default: ' + outputpath_default)
filename_default = config.get('DEFAULT', 'filename')
print('filename_default: ' + filename_default)

方式2：使用read_file()传入文件对象 #

如果必须手动打开文件，改用read_file()方法：

# 替换原读取代码块
print('Sections:')
with open("config.ini", "r") as configfile:
    config.read_file(configfile)  # 使用read_file而非read
print("All sections (excluding DEFAULT):", config.sections())

inputpath_default = config.get('DEFAULT', 'inputpath')
print('inputpath_default: ' + inputpath_default)
outputpath_default = config.get('DEFAULT', 'outputpath')
print('outputpath_default: ' + outputpath_default)
filename_default = config.get('DEFAULT', 'filename')
print('filename_default: ' + filename_default)

关键说明 #

• DEFAULT是configparser的特殊section，sections()方法不会返回它，但只要配置加载正确，就能通过config.get('DEFAULT', 'key')或直接config['DEFAULT']['key']获取配置项
• config.read()方法在文件不存在时不会抛出FileNotFoundError，而是返回空列表，因此可以省略手动的os.path.exists()判断，简化代码

内容的提问来源于stack exchange，提问作者GoneFishing