3. Config 文件解析工具：Python configparser 模块详解与 ini 文件解析实战

在 Linux 内核配置与系统调优工作中，ini 格式的配置文件 是最常见的结构化数据载体之一。Python 标准库中的 configparser 模块提供了高效、健壮的 ini 文件解析能力，是内核参数调优脚本的核心依赖。本节将深入剖析该模块的架构、核心 API 以及实战解析技巧。

3.1 ini 文件格式规范与 configparser 架构

ini 文件由 节（Section）、键（Key） 和 值（Value） 组成，支持注释与多行值。configparser 模块采用分层设计，将解析、存储与写入分离。

3.2 核心 API 速查表

以下表格汇总了 configparser 最常用的 API 方法，按功能分类，便于快速查阅。

3.3 实战：解析 Linux 内核参数配置文件

假设我们有一个模拟的内核参数配置文件 kernel_tune.ini，内容如下：

[kernel]
panic = 10
panic_on_oops = 1
softlockup_panic = 0
hung_task_timeout_secs = 120

[memory]
vm.swappiness = 10
vm.dirty_ratio = 20
vm.dirty_background_ratio = 5

[network]
net.core.somaxconn = 4096
net.ipv4.tcp_tw_reuse = 1
net.ipv4.tcp_fin_timeout = 15

以下是一个完整的解析脚本，展示如何读取、查询并输出配置：

import configparser

# 1. 创建 ConfigParser 实例
config = configparser.ConfigParser()

# 2. 读取 ini 文件
config.read('kernel_tune.ini')

# 3. 遍历所有节和键
for section in config.sections():
    print(f"[{section}]")
    for key in config.options(section):
        value = config.get(section, key)
        print(f"  {key} = {value}")
    print()

# 4. 使用类型安全方法获取特定参数
panic_value = config.getint('kernel', 'panic')
swappiness = config.getint('memory', 'vm.swappiness')
tcp_reuse = config.getboolean('network', 'net.ipv4.tcp_tw_reuse')

print(f"Kernel panic timeout: {panic_value} seconds")
print(f"VM swappiness: {swappiness}")
print(f"TCP TIME_WAIT reuse enabled: {tcp_reuse}")

输出结果：

[kernel]
  panic = 10
  panic_on_oops = 1
  softlockup_panic = 0
  hung_task_timeout_secs = 120

[memory]
  vm.swappiness = 10
  vm.dirty_ratio = 20
  vm.dirty_background_ratio = 5

[network]
  net.core.somaxconn = 4096
  net.ipv4.tcp_tw_reuse = 1
  net.ipv4.tcp_fin_timeout = 15

Kernel panic timeout: 10 seconds
VM swappiness: 10
TCP TIME_WAIT reuse enabled: True

3.4 高级特性：插值与默认值

configparser 支持 插值（Interpolation） 功能，允许在值中引用其他键的值，极大提升了配置的灵活性。

插值使用 %(key)s 语法，默认情况下 ConfigParser 启用 BasicInterpolation。如果需要禁用插值（例如值中包含 % 字符），可以在创建实例时设置：

config = configparser.ConfigParser(interpolation=None)

默认值 可以通过 defaults 参数或 [DEFAULT] 节设置，所有节均可访问：

config = configparser.ConfigParser(defaults={'timeout': '30'})
# 或在 ini 文件中添加 [DEFAULT] 节

3.5 常见陷阱与避坑指南

• 大小写敏感： 默认情况下，节名和键名是大小写敏感的。可以通过 ConfigParser(optionxform=str) 保持原始大小写。
• 重复键处理： 同一节内重复的键，后出现的值会覆盖先出现的值，不会报错。
• 注释符号： 支持 # 和 ; 作为行首注释，但注释不能出现在值中间。
• 多行值： 使用缩进续行，下一行必须以空白字符开头。
• 布尔值解析： getboolean() 只识别 1/0、yes/no、on/off、true/false，其他值会抛出 ValueError。

3.6 实战：将解析结果写入新配置文件

以下示例展示如何修改配置并写回文件，常用于自动化调优脚本：

import configparser

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

# 修改参数
config.set('kernel', 'panic', '20')
config.set('memory', 'vm.swappiness', '5')

# 添加新节
config.add_section('security')
config.set('security', 'selinux', 'enforcing')

# 写回文件
with open('kernel_tune_optimized.ini', 'w') as f:
    config.write(f)

print("优化后的配置文件已生成：kernel_tune_optimized.ini")

生成的 kernel_tune_optimized.ini 内容：

[kernel]
panic = 20
panic_on_oops = 1
softlockup_panic = 0
hung_task_timeout_secs = 120

[memory]
vm.swappiness = 5
vm.dirty_ratio = 20
vm.dirty_background_ratio = 5

[network]
net.core.somaxconn = 4096
net.ipv4.tcp_tw_reuse = 1
net.ipv4.tcp_fin_timeout = 15

[security]
selinux = enforcing