Python configparser模块应用过程解析

洛溪

发布时间：2026-10-14| 2人浏览过

原创

本文详细解析Python标准库configparser模块的使用方法。涵盖如何读取、写入及修改后缀为.ini的配置文件，通过字典形式和方法形式两种写入方式，结合具体代码示例，展示sections、options、items及get等核心API的实际应用，帮助开发者高效管理项目配置。

configparser模块简介

一、configparser模块是什么

该模块主要用于处理后缀名为 .ini 的配置文件格式；

它属于Python标准库的一部分，意味着它是Python环境自带的功能，用户无需额外安装任何第三方包即可使用。

configparser基本使用与示例

二、configparser模块基本使用

2.1 读取 ini 配置文件


#存在 config.ini 配置文件，内容如下：
[DEFAULT]
excel_path = ../test_cases/case_data.xlsx
log_path = ../logs/test.log
log_level = 1

[email]
user_name = 32@qq.com
password = 123456

下面演示如何使用configparser模块来读取现有的配置文件内容。


import configparser

#创建配置文件对象
conf = configparser.ConfigParser()
#读取配置文件
conf.read('config.ini', encoding="utf-8")
#列表方式返回配置文件所有的section
print( conf.sections() )  #结果：['default', 'email']
#列表方式返回配置文件email 这个section下的所有键名称
print( conf.options('email') )  #结果：['user_name', 'password']
#以[(),()]格式返回 email 这个section下的所有键值对
print( conf.items('email') )  #结果：[('user_name', '32@qq.com'), ('password', '123456')]
#使用get方法获取配置文件具体的值，get方法：参数1-->section(节) 参数2-->key(键名)
value = conf.get('default', 'excel_path')
print(value)

2.2 写入 ini 配置文件（字典形式）


import configparser

#创建配置文件对象
conf = configparser.ConfigParser()
#'DEFAULT'为section的名称，值中的字典为section下的键值对
conf["DEFAULT"] = {'excel_path' : '../test_cases/case_data.xlsx' , 'log_path' : '../logs/test.log'}
conf["email"] = {'user_name':'32@qq.com','password':'123456'}
#把设置的conf对象内容写入config.ini文件
with open('config.ini', 'w') as configfile:
  conf.write(configfile)

2.3 写入 ini 配置文件（方法形式）


import configparser

#创建配置文件对象
conf = configparser.ConfigParser()
#读取配置文件
conf.read('config.ini', encoding="utf-8")
#在conf对象中新增section
conf.add_section('webserver')
#在section对象中新增键值对
conf.set('webserver','ip','127.0.0.1')
conf.set('webserver','port','80')
#修改'DEFAULT'中键为'log_path'的值，如没有该键，则新建
conf.set('DEFAULT','log_path','test.log')
#删除指定section
conf.remove_section('email')
#删除指定键值对
conf.remove_option('DEFAULT','excel_path')
#写入config.ini文件
with open('config.ini', 'w') as f:
  conf.write(f)

上述三个示例基本涵盖了configparser模块的核心功能点；

在例1中，设置 encoding="utf-8" 是为了防止读取包含中文内容的配置文件时出现乱码现象；
例2的操作可以理解为在字典结构中新增数据，其中键对应配置文件中的section（节），格式为字符串；值则对应section下的具体键值对，格式为字典；
在例3中，当调用add_section方法时，如果配置文件中已经存在该section，程序会抛出错误；而使用set方法时，若该键已存在则进行值修改，若不存在则新建该键值对。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。