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
来管理你的程序配置了。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据类型有哪几种
数据类型有哪几种

数据类型有整型、浮点型、字符型、字符串型、布尔型、数组、结构体和枚举等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

337

2023.10.31

php数据类型
php数据类型

本专题整合了php数据类型相关内容,阅读专题下面的文章了解更多详细内容。

224

2025.10.31

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

138

2026.02.12

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1566

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

649

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1228

2024.03.22

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

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

精品课程

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

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

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

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