章
目
录
INI文件格式因其简洁明了的结构，被广泛应用于各类项目中。那么，如何在Python中解析INI文件呢？今天这篇文章就带你深入了解。
一、INI文件格式基础
INI文件主要由节（section）和键值对（key-value）组成，结构清晰，便于管理配置信息。举个例子，下面是一个简单的INI文件示例：
[Section1]
key1 = value1
key2 = value2
[Section2]
key3 = value3
在这个示例中：
- 节（Section）：用
[SectionName]表示，就像一个分类标签，用于将相关的配置项进行分组。比如[Section1]和[Section2]，可以把不同功能模块的配置分别放在不同的节里，方便管理。 - 键值对（Key-Value）：遵循
key = value的格式，是具体的配置内容。key是配置项的名称，value是对应的值，就像一个“名字 – 值”的组合，用来记录具体的配置信息。 - 注释：以
#或;开头的内容是注释，用于对配置项进行说明，增强文件的可读性，在解析时会被忽略。
二、使用configparser模块解析INI文件
在Python中，解析INI文件通常会用到标准库中的configparser模块，它提供了丰富的功能，方便我们读取、写入和管理INI文件。
（一）安装说明
configparser是Python标准库的一部分，无需额外安装，只要你的Python环境正常，就可以直接使用，这为我们解析INI文件提供了极大的便利。
（二）基本操作流程
- 导入模块：在Python代码中，首先要导入
configparser模块，这样才能使用其中的功能。代码如下：
import configparser
- 创建解析器对象：导入模块后，需要创建一个
ConfigParser对象，这个对象就像是一个专门用来处理INI文件的“小助手”。代码如下：
config = configparser.ConfigParser()
- 读取INI文件：使用创建好的对象读取INI文件，
read方法会返回成功读取的文件列表。假设我们有一个名为config.ini的文件，读取代码如下：
config.read('config.ini') # 返回成功读取的文件列表
- 访问配置项：读取文件后，就可以获取具体的配置项了。比如要获取
Section1节下key1的值，可以使用get方法，它会返回对应的值（默认是字符串类型）。代码如下：
value = config.get('Section1', 'key1') # 获取字符串值
三、configparser模块常用方法
（一）读取操作
- 获取所有节：想知道INI文件中都有哪些节，可以使用
sections方法，它会返回一个包含所有节名称的列表。代码如下：
sections = config.sections() # 返回所有节的列表
- 获取某个节的所有键：如果只想获取某个特定节下的所有键，可以使用
options方法。例如，获取Section1节的所有键，代码如下：
keys = config.options('Section1') # 返回键的列表
- 获取键值对：使用
items方法可以获取某个节下所有的键值对，返回的是一个包含元组的列表，每个元组就是一个键值对。示例代码如下：
items = config.items('Section1') # 返回[(key1, value1), (key2, value2)]
- 获取特定类型的值：
configparser模块还能自动转换值的类型。比如，要获取Section1节下key1的值并转换为整数类型，可以使用getint方法；同理，getfloat和getboolean方法分别用于获取浮点数和布尔类型的值。代码如下：
# 自动转换类型
value_int = config.getint('Section1', 'key1')
value_float = config.getfloat('Section1', 'key2')
value_bool = config.getboolean('Section2', 'key3')
- 检查节或键是否存在：在处理INI文件时，有时需要判断某个节或键是否存在，可以使用
has_section和has_option方法。示例代码如下：
has_section = config.has_section('Section1')
has_key = config.has_option('Section1', 'key1')
（二）写入操作
- 添加/修改节和键值对：如果需要添加新的节或修改已有的键值对，可以使用
add_section和set方法。例如，添加一个新节NewSection，并在其中添加一个键值对，代码如下：
config.add_section('NewSection')
config.set('NewSection', 'new_key', 'new_value')
- 删除节或键：当某些节或键不再需要时，可以使用
remove_option和remove_section方法进行删除。示例代码如下：
config.remove_option('Section1', 'key1')
config.remove_section('Section1')
- 保存到文件：对INI文件进行修改后，需要将修改保存到文件中。可以使用
with open语句结合write方法来实现。示例代码如下：
with open('new_config.ini', 'w') as f:
config.write(f)
四、处理默认值
在解析INI文件时，我们可能希望在某些配置项不存在时使用默认值。configparser模块提供了两种设置默认值的方式：
- 初始化时设置默认节：在创建
ConfigParser对象时，可以通过defaults参数设置默认节（DEFAULT）。 - 读取时指定回退值：在使用
get方法获取配置项的值时，可以通过fallback参数指定回退值。例如：
# 获取值时优先查找DEFAULT节
value = config.get('Section1', 'key1', fallback="default_value")
五、高级配置
在创建ConfigParser对象时，还可以通过一些参数来调整其行为，以满足不同的需求。比如：
config = configparser.ConfigParser(
allow_no_value=True, # 允许键没有值（如空键）
delimiters=('=', ':'), # 分隔符
comment_prefixes=('#', ';'), # 注释符号
strict=False # 是否严格检查重复节或键
)
allow_no_value=True：表示允许键没有对应的值，即可以存在空键。delimiters=('=', ':')：指定键值对的分隔符，默认是=，这里增加了:也可作为分隔符。comment_prefixes=('#', ';')：设置注释符号，除了默认的#，还可以用;开头表示注释。strict=False：表示不严格检查重复的节或键，在某些情况下，这可以方便处理一些特殊的配置文件。
六、示例代码演示
（一）读取并打印配置
下面的代码展示了如何读取INI文件，并将其中的配置信息打印出来：
import configparser
config = configparser.ConfigParser()
config.read('config.ini')
for section in config.sections():
print(f'[{section}]')
for key, value in config.items(section):
print(f'{key} = {value}')
这段代码首先导入configparser模块，创建解析器对象并读取INI文件。然后通过循环遍历每个节及其键值对，并将它们打印出来，方便查看INI文件的内容。
（二）修改并保存配置
接下来的代码演示了如何修改INI文件中的配置项，添加新的节和键值对，并保存修改后的内容：
config.set('Section1', 'key1', 'updated_value')
config.add_section('NewSection')
config.set('NewSection', 'new_key', '123')
with open('updated_config.ini', 'w') as f:
config.write(f)
在这段代码中，先修改了Section1节下key1的值，接着添加了新节NewSection并设置了一个新的键值对，最后将修改后的配置保存到updated_config.ini文件中。
七、注意事项
在使用configparser模块解析INI文件时，有几个地方需要注意：
- 大小写敏感：默认情况下，
configparser会将键名转换为小写。如果希望保持键名的原始大小写，可以通过config = configparser.ConfigParser(converters={})禁用这种转换。 - 保留注释：
configparser模块本身不会保留INI文件中的原始注释，如果需要保留注释，可能需要使用第三方库，比如configobj来处理。 - 文件编码：
configparser默认使用系统编码读取和写入文件。如果需要指定其他编码，建议使用open函数显式处理，以确保正确处理文件内容。
通过以上介绍，相信你对在Python中解析INI文件已经有了较为全面的了解。configparser模块提供了丰富的功能来满足基本的INI文件处理需求，如果项目中需要更复杂的功能，例如处理嵌套节或进行类型验证等，可以考虑使用第三方库，如configobj或toml 。希望这篇文章能帮助你在Python开发中更好地处理INI文件。
