Python解析INI配置文件详解（小白也能学会的configparser模块使用指南）

什么是INI配置文件？

INI 文件是一种结构化的纯文本配置文件，通常以 .ini 为扩展名。它的基本结构由节（section）和键值对（key-value pairs）组成。

一个典型的 INI 文件内容如下：

[database]host = localhostport = 3306username = adminpassword = secret123[api]base_url = https://api.example.comtimeout = 10

可以看到，INI 文件用方括号 [] 定义节，每个节下包含多个 key = value 的配置项。

Python 如何读取 INI 文件？

Python 标准库提供了 configparser 模块，专门用于处理 INI 格式的配置文件。无需安装第三方库，开箱即用！

步骤 1：创建一个 INI 文件

首先，我们在项目根目录下创建一个名为 config.ini 的文件，内容如下：

[server]ip = 192.168.1.100port = 8080[logging]level = INFOfile = app.log

步骤 2：使用 configparser 读取配置

接下来，我们编写 Python 脚本读取这个配置文件：

import configparser# 创建 ConfigParser 对象config = configparser.ConfigParser()# 读取 INI 文件config.read('config.ini')# 获取某个节下的所有键值对server_ip = config['server']['ip']server_port = config['server']['port']print(f"服务器IP: {server_ip}")print(f"端口: {server_port}")# 获取日志级别log_level = config.get('logging', 'level')print(f"日志级别: {log_level}")

运行上述代码，输出结果为：

服务器IP: 192.168.1.100端口: 8080日志级别: INFO

写入或修改 INI 文件

除了读取，configparser 还支持动态修改配置并写回文件。

import configparserconfig = configparser.ConfigParser()config.read('config.ini')# 修改配置config.set('server', 'port', '9000')# 新增一个节if not config.has_section('email'):    config.add_section('email')config.set('email', 'smtp_server', 'smtp.example.com')config.set('email', 'port', '587')# 写回文件with open('config.ini', 'w', encoding='utf-8') as configfile:    config.write(configfile)print("配置已更新！")

执行后，config.ini 文件将自动更新，新增了 [email] 节，并修改了服务器端口。

常见问题与技巧

• 中文支持：如果 INI 文件包含中文，请确保在 read() 时指定编码，例如：config.read('config.ini', encoding='utf-8')。
• 默认值：使用 get() 方法时可以设置默认值，避免 KeyError：
  timeout = config.get('api', 'timeout', fallback='5')
• 类型转换：INI 文件中的值都是字符串，如需整数或布尔值，需手动转换：
  port = int(config['server']['port'])

总结

通过本文，你已经掌握了如何使用 Python 的 configparser 模块进行 INI 文件读写教程 的完整流程。无论是读取配置、动态修改，还是处理中文和默认值，你都能轻松应对。这种 Python配置管理 方式非常适合中小型项目，简洁高效。

记住，良好的配置管理能让你的代码更清晰、更易维护。快去试试吧！

SEO关键词回顾：Python解析ini配置文件、configparser模块使用、ini文件读写教程、Python配置管理