Python如何操作INI配置文件？configparser模块-Python教程-PHP中文网

Python如何操作INI配置文件？configparser模块

雪夜

发布： 2025-08-18 20:01:01

原创

155人浏览过

使用configparser读取ini文件需创建configparser对象并调用read()方法，之后可通过字典方式访问配置项，并用getint()、getboolean()等方法转换数据类型；2. 修改配置直接赋值，写入文件需使用with open()打开文件并调用config.write()方法确保文件正确保存；3. 处理注释和空行时，configparser默认忽略;或#开头的行及空行，可自定义comment_prefixes和inline_comment_prefixes设置注释符号；4. 默认section和option名称转为小写，若需保持大小写敏感，应设置optionxform=str；5. 创建新section需调用add_section()方法并检查是否存在以避免duplicatesectionerror，再添加option；6. 避免读取异常应使用has_section()和has_option()预先判断或用try...except捕获keyerror；7. 多线程环境下configparser非线程安全，需使用threading.lock()保证读写操作的互斥性，防止数据竞争和文件损坏。

Python如何操作INI配置文件？configparser模块

Python操作INI配置文件，核心在于

configparser

登录后复制

模块。它提供了一种简单有效的方式来读取、修改和写入INI格式的配置文件，让你的程序可以灵活地根据配置运行，而无需硬编码。

configparser模块

INI配置文件通常用于存储程序的配置信息，例如数据库连接字符串、API密钥、程序运行参数等等。

configparser

登录后复制

模块使得这些配置的管理变得非常方便。

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

如何使用configparser读取INI文件？

首先，你需要创建一个

configparser

登录后复制

对象，然后使用

read()

登录后复制

方法读取INI文件。读取后，你可以像访问字典一样访问配置项。

import configparser

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

# 获取某个section下的option值
db_host = config['database']['host']
db_port = config['database'].getint('port') # 确保读取的是整数类型

print(f"数据库主机：{db_host}, 端口：{db_port}")

登录后复制

注意，

getint()

登录后复制

、

getboolean()

登录后复制

、

getfloat()

登录后复制

等方法可以帮助你将读取到的字符串转换为相应的类型。如果配置项不存在，会抛出

NoOptionError

登录后复制

或

NoSectionError

登录后复制

，所以最好用

try...except

登录后复制

处理一下。

如何修改和写入INI文件？

修改配置很简单，直接赋值即可。写入文件则需要使用

write()

登录后复制

方法。

config['database']['host'] = 'new_host'
config['database']['timeout'] = '15'  # 字符串形式

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

登录后复制

这里有个小技巧，写入时最好使用

with open()

登录后复制

语句，这样可以确保文件在使用完毕后被正确关闭，防止数据丢失。另外，

config.write()

登录后复制

会将所有配置都写入文件，即使你只修改了一项。

如何处理INI文件中的注释和空行？

configparser

登录后复制

默认会忽略以

登录后复制

或

登录后复制

开头的行作为注释，也会忽略空行。如果你需要自定义注释符号，可以在创建

configparser

登录后复制

对象时指定

comment_prefixes

登录后复制

和

inline_comment_prefixes

登录后复制

参数。

config = configparser.ConfigParser(comment_prefixes=('#',), inline_comment_prefixes=(';',))

登录后复制

这会把

登录后复制

作为行注释符，

登录后复制

作为行内注释符。

如何处理大小写敏感问题？

默认情况下，

configparser

登录后复制

会将section和option名称转换为小写。如果你需要保持大小写敏感，可以在创建

configparser

登录后复制

对象时设置

optionxform

登录后复制

参数为一个函数，例如

str

登录后复制

。

config = configparser.ConfigParser()
config.optionxform = str # 保持大小写

登录后复制

不过，我个人建议还是统一使用小写，这样可以避免很多潜在的错误。

如何在INI文件中创建新的section和option？

创建新的section使用

add_section()

登录后复制

方法，然后像修改现有配置一样添加option。

config.add_section('new_section')
config['new_section']['new_option'] = 'new_value'

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

登录后复制

记住，创建section之前要检查它是否已经存在，否则会抛出

DuplicateSectionError

登录后复制

。

如何避免读取配置时出现异常？

读取配置时，最常见的异常是

NoSectionError

登录后复制

和

NoOptionError

登录后复制

。为了避免程序崩溃，可以使用

has_section()

登录后复制

和

has_option()

登录后复制

方法先判断section和option是否存在。

if config.has_section('database') and config.has_option('database', 'host'):
    db_host = config['database']['host']
    print(f"数据库主机：{db_host}")
else:
    print("数据库配置不存在")

登录后复制

或者，使用

try...except

登录后复制

语句捕获异常。

try:
    db_host = config['database']['host']
    print(f"数据库主机：{db_host}")
except KeyError:
    print("数据库配置不存在")

登录后复制

选择哪种方式取决于你的具体需求和代码风格。

如何在多线程环境中使用configparser？

configparser

登录后复制

本身不是线程安全的。如果在多线程环境中同时读写同一个INI文件，可能会导致数据竞争和文件损坏。为了解决这个问题，可以使用锁机制来保护对配置文件的访问。

import threading

lock = threading.Lock()

def read_config(key):
    with lock:
        config = configparser.ConfigParser()
        config.read('config.ini')
        return config['section'][key]

def write_config(key, value):
    with lock:
        config = configparser.ConfigParser()
        config.read('config.ini')
        config['section'][key] = value
        with open('config.ini', 'w') as configfile:
            config.write(configfile)

登录后复制

使用