如何在Python中对INI配置文件进行读取与动态修改

酷宇小哥_3036

酷宇小哥_3036

2026-10-15

273人浏览

原创

configparser 默认将 section 和 option 名转为小写,需设 optionxform = str 保留原始大小写;写入时 config.write() 不保留注释和空行;新增选项前须先 add_section();多环境配置可通过顺序读取多个文件实现覆盖。

如何在python中对ini配置文件进行读取与动态修改

用 configparser 读取 INI 文件时,为什么 section 名会自动转小写?

默认情况下,ConfigParser 会把所有 section 名和 option 名转成小写,这是它的默认行为,不是 bug。如果你的 INI 文件里写了 [Database],读出来变成 database,后续用 config.has_section("Database") 就会返回 False。

解决方法是禁用大小写转换:

from configparser import ConfigParser
<p>config = ConfigParser()
config.optionxform = str  # 关键:保留原始大小写
config.read("config.ini")
</p>
  • 必须在 read() 之前设置 optionxform = str,设晚了无效
  • 如果只读不写,且确定所有 section 都是小写,可以跳过这步;但只要涉及写入或大小写敏感场景,务必加
  • Python 3.2+ 支持 ConfigParser(interpolation=None),但大小写问题仍需手动处理

修改值后如何安全写回文件,避免覆盖原有注释和空行?

config.write() 不保留注释、空行、原始缩进,它只输出纯结构化内容。如果你的 config.ini 原本有注释如 # timeout in seconds,调用 write() 后就没了。

真实项目中,推荐两种策略:

python-parallelization
python-parallelization

将顺序 Python 代码转换为并行/并发实现,用于在需要并行化 Python 代码、提升性能时使用。

下载
  • 接受无注释:仅用于自动化配置生成(如 CI 环境),直接用 config.write(open("config.ini", "w"))
  • 保留格式:改用 configparser.RawConfigParser + 手动拼接,或换用第三方库如 configobj(支持注释保留)
  • 折中方案:把用户可编辑部分(如 [user])和程序自动生成部分(如 [generated])拆到不同文件,只对后者用 write()

写入新 section 或 option 时,set() 报错 NoSectionError 怎么办?

config.set(section, option, value) 要求 section 必须已存在,否则抛 NoSectionError。不能靠 set() 自动创建 section。

正确流程是分两步:

if not config.has_section("Logging"):
    config.add_section("Logging")
config.set("Logging", "level", "DEBUG")
  • add_section() 不能带 =,也不能重复添加,否则报 DuplicateSectionError
  • set() 的 value 必须是字符串;传 int 或 bool 会报 TypeError
  • 想批量写入字典?得遍历:for k, v in my_dict.items(): config.set("Section", k, str(v))

多环境配置(dev/test/prod)怎么用同一份代码切换?

INI 本身不支持“继承”或“环境变量插值”,但可以用组合方式模拟:

  • 主配置 base.ini 放通用项,各环境文件(dev.ini、prod.ini)只写差异项
  • 用 config.read([base_file, env_file]) 顺序读取,后读的覆盖前读的同名 key
  • 注意:覆盖只发生在相同 section+option,不会自动合并 list 或 dict 类型值
  • 如果需要运行时替换变量(如 host = ${DB_HOST}),启用插值:ConfigParser(interpolation=BasicInterpolation()),但要确保环境变量已注入 os.environ

最常被忽略的是路径加载顺序——read() 返回的是成功加载的文件列表,如果某个环境文件路径错或权限不足,它会静默跳过,导致你以为切到了 prod,实际还在用 base 配置。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

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

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

2023.07.20

1731

4

python能做什么
python能做什么

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

2023.07.25

4424

7

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

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

2023.07.31

1709

3

python教程
python教程

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

2023.08.03

25917

23

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

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

2023.08.04

3147

5

python eval
python eval

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

2023.08.04

3167

5

scratch和python区别
scratch和python区别

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

2023.08.11

1183

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2463

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习