Python3中configparser模块读写ini文件并解析配置的用法详解
发布时间：2026-10-14| 5人浏览过
本文详解Python3中configparser模块的用法，涵盖初始化、读取ini文件、获取sections与keys、增删改配置项及[DEFAULT]特殊处理。通过实例展示如何解析键值对，注意大小写转换与写入生效机制，帮助开发者高效管理配置文件。
Python3中configparser模块简介
configparser 是 Python 标准库中用于解析配置文件的模块，其内置方法与字典操作高度相似。在 Python2.x 版本中该模块名为 ConfigParser，而在 Python3.x 中已统一改为小写 configparser，并新增了一些实用功能。
配置文件的格式如下：
[DEFAULT]
ServerAliveInterval = 45
Compression = yes
CompressionLevel = 9
ForwardX11 = yes
[bitbucket.org]
User = Tom
[topsecret.com]
Port: 50022
ForwardX11: no方括号“[ ]”内包含的是 section（节）名称，section 下方则是类似于 key - value 的配置内容；
configparser 默认支持使用 ‘=' 和 ‘：' 作为键值分隔符。
configparser 常用方法
初始化实例
使用 configparser 首先需要初始化实例，并读取配置文件：
>>> import configparser
>>> config = configparser.ConfigParser() # 注意大小写
>>> config.read("config.ini") # 配置文件的路径
["config.ini"]或者可以直接读字典
>>> parser = configparser.ConfigParser()
>>> parser.read_dict({'section1': {'key1': 'value1',
... 'key2': 'value2',
... 'key3': 'value3'},
... 'section2': {'keyA': 'valueA',
... 'keyB': 'valueB',
... 'keyC': 'valueC'},
... 'section3': {'foo': 'x',
... 'bar': 'y',
... 'baz': 'z'}
... })获取所有 sections
>>> config.sections()
['bitbucket.org', 'topsecret.com'] # 注意会过滤掉[DEFAULT]获取指定 section 的 keys & values
>>> config.items('topsecret.com')
>>>> [('port', '50022'), ('forwardx11', 'no')] # 注意items()返回的字符串会全变成小写获取指定 section 的 keys
>>> config.options('topsecret.com')
['Port', 'ForwardX11']
>>> for option in config['topsecret.com']:
... print(option)
Port
ForwardX11获取指定 key 的 value
>>> config['bitbucket.org']['User']
'Tom'
>>> config.get('bitbucket.org', 'User')
'Tom'
>>> config.getint('topsecret.com', 'Port')
50022configparser模块检查
>>> 'DEFAULT' in config
True
>>> 'test' in config['section_test']
False
>>> 'Tom' in config['bitbucket.org']['User']
True
>>> config.has_section('bitbucket.org')
True
>>> config.has_option('section_test', 'test')
Falseconfigparser模块添加
>>> config.add_section('Section_1')
>>> config.set('Section_1', 'key_1', 'value_1') # 注意键值是用set()方法
>>> config.write(open('config.ini', 'w')) # 一定要写入才生效configparser模块删除
>>> config.remove_option('Section_1', 'key_1')
True
>>> config.remove_section('Section_1')
True
>>> config.clear() # 清空除[DEFAULT]之外所有内容
>>> config.write(open('config.ini', 'w'))关于 [DEFAULT]
[DEFAULT] 通常包含 ini 格式配置文件的默认项，因此 configparser 的部分方法会自动跳过处理这个 section。
前面已经提到 sections() 是获取不到的，还有删除方法对 [DEFAULT] 也无效：
>>> config.remove_section('DEFAULT')
False
>>> config.clear()
>>> 'DEFAULT' in config
True
>>> 'ForwardX11' in config['DEFAULT']
True
>>> config.sections()
[]但指定删除和修改 [DEFAULT] 里的 keys & values 是可以的：
>>> config.remove_option('DEFAULT', 'ForwardX11')
True
>>> config.set('DEFAULT', 'ForwardX11','no')
>>> config['DEFAULT']['ForwardX11']
'no'还有个特殊的是，has_section() 也无效，可以和 in 区别使用
>>> config.has_section('DEFAULT')
False
>>> 'DEFAULT' in config
True更多关于Python3中configparser模块读写ini文件并解析配置的用法请查看下面的相关链接
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
