在软件开发中，管理应用配置是一个常见但至关重大的任务。Python 的 configparser 模块提供了一种简洁的方式来读取、写入和管理配置文件，使开发者可以轻松地在代码中集成动态配置选项。今天，钢铁老豆就快速过一遍这个内置模块，毕竟这个是我刚自学Python时使用的第一个配置模块，后续还会介绍更多其他场景的替代模块，列如PyYaml，关注我，别错过！

0.configparser介绍

configparser 模块用于处理配置文件，这些文件一般保存在.ini格式中。INI 文件结构简洁，通过分段和键值对的方式组织信息，使得它们易于阅读和编写。

1.快速上手

假设我们有一个名为 example.ini 的配置文件，其内容如下：

[DEFAULT]
ServerAliveInterval = 45
Compression = yes
CompressionLevel = 9

[bitbucket.org]
User = hg

[topsecret.server.com]
Port = 50022
ForwardX11 = no

1.1 导入模块并创建配置解析器

第一需要导入模块，并创建一个 ConfigParser 对象：

from configparser import ConfigParser

# 创建ConfigParser对象
config = ConfigParser()

1.2 读取配置文件

加载和读取这个配置文件

config.read('example.ini')

如果你想确认哪些文件被成功读取了，read 方法会返回一个包含成功读取的文件名列表。

1.3 获取配置值

你可以通过配置解析器对象像操作字典一样访问任何部分（section）和选项（option）。

# 访问 'bitbucket.org' 部分下的 'User' 选项
user = config['bitbucket.org']['User']
print(user)  # 输出: hg

如果尝试访问不存在的键或部分，会引发 KeyError 或 NoSectionError。为了避免程序因错误而中断，你可以使用异常处理或检查键是否存在。

# 方式一：使用异常处理
try:
    user = config['bitbucket.org']['User']
except KeyError:
    print("未找到指定的键或部分。")

# 方式二：检查键是否存在
if 'bitbucket.org' in config and 'User' in config['bitbucket.org']:
    user = config['bitbucket.org']['User']
else:
    print("未找到指定的键或部分。")

configparser 提供了一些方法来协助你将配置值转换为特定的数据类型，这对于需要确保数据类型正确性的情况超级有用。

# getint：获取一个整数类型的配置值，如果值不能转换为整数，将引发 ValueError
port = config.getint('topsecret.server.com', 'Port')
print(port)  # 输出: 50022

# getfloat：获取一个浮点数类型的配置值，如果值不能转换为浮点数，将引发 ValueError
timeout = config.getfloat('server', 'Timeout')

# getboolean：获取一个布尔类型的配置值
# 布尔值可以是 'true'/'yes'/'on'/'1' 中的任何一个来表明真，或者是 'false'/'no'/'off'/'0' 中的任何一个来表明假
compression = config.getboolean('DEFAULT', 'Compression')

# 支持自定义类型转换：支持为除了整数、浮点数和布尔值之外的其他数据类型，注册新的转换器
# 定义一个转换器来处理复杂数
def complex_type(value):
    return complex(value)

config = ConfigParser(converters={'complex': complex_type})
config.read('example.ini')
comp_value = config.getcomplex('Section', 'ComplexValue')

1.4 修改和保存配置文件

可以直接修改配置解析器对象中的值，或添加新的部分和选项

# 修改现有的选项值
config['bitbucket.org']['User'] = 'git'

# 添加新的部分和选项
config['default']['Browser'] = 'Firefox'

1.5 写入配置文件

修改配置数据后，可以将更新写回文件，实现配置的持久化：

with open('example_modified.ini', 'w') as configfile:
    config.write(configfile)

2.高级用法

configparser 还支持更多高级功能，如继承默认值、转换数据类型、自定义选项解析等。通过这些功能，开发者可以实现更复杂的配置管理策略。由于篇幅关系，钢铁老豆会留待后来有机会再给大家展开讲解，大家也可以参考Python官网自行学习。

欢迎点赞+收藏+评论+关注，每天学习一点Python小知识，无论基础、模块、数据分析、深度学习和Ai，总有你感兴趣的。我是钢铁老豆，一个30岁转行IT、自学成为算法工程师、想用Ai点亮孩子小小世界的Pythoner。