Python里configparser用法配置文件解析模块configparser实战-Python教程-PHP中文网

Python里configparser用法配置文件解析模块configparser实战

尼克

发布： 2025-06-06 16:39:03

原创

500人浏览过

python的configparser模块用于读写.ini格式配置文件，适合基础配置管理。它支持节（section）和键值对结构，其中default节可被继承；使用configparser实例读取文件，并通过getint()、getboolean()等方法获取特定类型值；写入配置需手动打开文件并调用write()方法；此外，支持变量插值、保留大小写(optionxform=str)及设置fallback避免keyerror，适用于小型项目或脚本工具。

在Python中处理配置文件时，configparser是一个非常实用的模块。它能读取和写入.ini格式的配置文件，结构清晰、使用简单，适合做程序的基础配置管理。

配置文件基本格式

configparser处理的是类似 .ini 文件的内容，这种文件通常由多个“节（section）”组成，每个节下面包含若干键值对：

[DEFAULT]
host = localhost
port = 5432

[database]
user = admin
password = secret

登录后复制

上面的例子中，[DEFAULT] 是一个特殊节，它的配置会被其他所有节继承。比如，如果某个节没有定义 host，就会去 DEFAULT 中找。

基本用法：读取配置

要读取配置文件，首先需要创建一个 ConfigParser 实例，然后调用 read() 方法加载文件：

立即学习“Python免费学习笔记（深入）”；

import configparser

config = configparser.ConfigParser()
config.read('config.ini')

print(config['database']['host'])  # 输出: localhost
print(config['database']['user'])  # 输出: admin

登录后复制

需要注意几点：

节名和键名是大小写敏感的（默认情况下）
所有值都会被当作字符串返回
可以用 getint()、getboolean() 等方法获取特定类型

例如：

port = config.getint('database', 'port')
is_debug = config.getboolean('DEFAULT', 'debug', fallback=False)

登录后复制

写入或修改配置

除了读取，configparser 还可以用来生成或修改配置文件：

config = configparser.ConfigParser()

config['DEFAULT'] = {
    'host': 'localhost',
    'port': '5432'
}

config['database'] = {}
config['database']['user'] = 'admin'
config['database']['password'] = 'secret'

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

登录后复制

这样就生成了一个新的配置文件。注意：

添加节的时候要用字典方式赋值或者使用 add_section() 方法
写入文件时必须手动打开并调用 write()
不支持注释保存，原有注释会被丢弃

一些容易忽略的细节

变量插值
configparser 支持变量引用，格式是 ${section:key}：
```
[paths]
home = /home/user
log_dir = ${home}/logs
```
登录后复制
在代码中可以直接读取 log_dir，会自动替换为完整路径。
区分大小写问题
默认不区分大小写，可以通过设置 optionxform=str 来保留原始大小写：
```
config = configparser.ConfigParser()
config.optionxform = str  # 保持键名大小写不变
```
登录后复制
fallback 参数
获取值时推荐使用 get() 并提供 fallback，避免 KeyError：
```
user = config.get('database', 'username', fallback='guest')
```
登录后复制