Python configparser详解（小白也能轻松掌握INI配置文件读写与管理）

什么是INI配置文件？

INI文件是一种简单的文本格式，常用于存储程序的配置信息。它的结构清晰，由节（section）、键（key）和值（value）组成。例如：

[database]host = localhostport = 3306username = adminpassword = secret123[server]debug = Trueport = 8000

1. 导入configparser模块

首先，我们需要导入Python内置的 configparser 模块：

import configparser

2. 读取INI配置文件

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

[database]host = 127.0.0.1port = 5432user = myuser[app]debug = falseversion = 1.0.0

我们可以使用以下代码读取它：

import configparser# 创建ConfigParser对象cfg = configparser.ConfigParser()# 读取配置文件cfg.read('config.ini')# 获取某个节下的某个值host = cfg.get('database', 'host')port = cfg.getint('database', 'port')  # 自动转为整数debug = cfg.getboolean('app', 'debug')  # 自动转为布尔值print(f"数据库主机: {host}")print(f"数据库端口: {port}")print(f"调试模式: {debug}")

注意：getint()、getboolean() 等方法可以自动将字符串转换为对应的数据类型，非常方便！

3. 写入INI配置文件

我们也可以动态创建或修改配置并保存到文件：

import configparser# 创建ConfigParser对象cfg = configparser.ConfigParser()# 添加一个节cfg['logging'] = {    'level': 'INFO',    'file': 'app.log',    'max_size': '10MB'}# 添加另一个节cfg['cache'] = {}cache = cfg['cache']cache['enabled'] = 'true'cache['ttl'] = '3600'# 将配置写入文件with open('new_config.ini', 'w', encoding='utf-8') as f:    cfg.write(f)

执行后，会生成一个 new_config.ini 文件，内容如下：

[logging]level = INFOfile = app.logmax_size = 10MB[cache]enabled = truettl = 3600

4. 常用方法总结

• cfg.sections()：获取所有节名列表
• cfg.options(section)：获取某节下所有键名
• cfg.has_section(section)：判断是否存在某节
• cfg.has_option(section, option)：判断某节是否存在某键
• cfg.remove_section(section)：删除整个节
• cfg.remove_option(section, option)：删除某节下的某个键

5. 实际应用场景

使用 Python configparser 可以轻松实现：

• Web应用的数据库连接配置
• 日志级别和路径设置
• API密钥和第三方服务凭证管理（建议配合环境变量使用更安全）
• 多环境配置（开发、测试、生产）切换

小贴士

- INI文件不支持嵌套结构，适合简单配置
- 敏感信息（如密码）建议不要明文存储，可结合加密或环境变量
- configparser 默认区分大小写，但可通过设置忽略大小写

结语

通过本教程，你已经掌握了 Python configparser 的基本用法，能够熟练进行 配置文件解析、INI文件读写 和 Python配置管理。希望这些知识能帮助你在实际项目中更高效地管理配置信息！