0

0

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

雪夜

雪夜

发布时间:2025-08-18 20:01:01

|

239人浏览过

|

来源于php中文网

原创

使用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=(';',))

这会把

#
作为行注释符,
;
作为行内注释符。

情感家园企业站5.0 多语言多风格版
情感家园企业站5.0 多语言多风格版

一套面向小企业用户的企业网站程序!功能简单,操作简单。实现了小企业网站的很多实用的功能,如文章新闻模块、图片展示、产品列表以及小型的下载功能,还同时增加了邮件订阅等相应模块。公告,友情链接等这些通用功能本程序也同样都集成了!同时本程序引入了模块功能,只要在系统默认模板上创建模块,可以在任何一个语言环境(或任意风格)的适当位置进行使用!

下载

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

默认情况下,

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)

使用

threading.Lock()
创建一个锁对象,然后在读写配置文件之前获取锁,操作完成后释放锁。这样可以确保同一时刻只有一个线程可以访问配置文件。

虽然

configparser
用起来很简单,但还是有一些需要注意的地方。比如,配置文件格式要符合INI规范,否则可能无法正确解析。另外,要注意数据类型的转换,以及异常处理。掌握了这些技巧,你就可以轻松地使用
configparser
来管理你的程序配置了。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

760

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

639

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

762

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1265

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

549

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

709

2023.08.11

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

72

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 4万人学习

Django 教程
Django 教程

共28课时 | 3.2万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号