Python中配置文件的全面解析与使用

顺亿

2026-10-07 • 👁 0人浏览过

一、INI配置文件

二、YAML配置文件

三、JSON配置文件

四、TOML配置文件

五、XML配置文件

总结在Python开发中，配置文件扮演着举足轻重的角色。它们允许开发者在不修改代码的情况下调整应用程序的行为。无论是简单的键值对，还是复杂的嵌套结构，配置文件都能灵活应对。本文将详细介绍五种常见的Python配置文件格式：INI、YAML、JSON、TOML和XML，包括它们的样例文件、特点、使用场景以及解析代码

一、INI配置文件

1. 样例文件（config.ini）

[database]host = localhost port = 3306 username = admin password = 123456

[smtp]server = smtp.gmail.com port = 587 username = user@gmail.com password = password

2. 特点与使用场景

INI文件结构简单，由节（section）、键（key）和值（value）组成。常用于Windows系统的参数配置，适合存储简单的键值对配置。

3. 解析代码

import configparser


# 实例化ConfigParser对象conf = configparser.ConfigParser() conf.read('config.ini', encoding='utf-8')
# 获取指定section下的配置database_host = conf['database']['host']smtp_server = conf['smtp']['server']

print(f"Database host: {database_host}") print(f"SMTP server: {smtp_server}")

4. 代码解释

使用configparser.ConfigParser()实例化对象。

使用conf.read()方法读取配置文件。

通过字典方式访问指定section下的配置。

二、YAML配置文件

1. YAML配置规则

大小写敏感：YAML中的键（key）是大小写敏感的。

缩进：YAML使用缩进来表示数据的层次结构，通常使用两个空格或一个制表符（Tab）进行缩进，但不能混合使用。

注释：YAML中的注释以#符号开始，直到行尾。

数据类型：YAML支持多种数据类型，包括标量（字符串、整数、浮点数、布尔值）、序列（列表）、映射（字典）和复合结构。

引号：字符串可以使用单引号（'）、双引号（"）或不使用引号。不使用引号时，特殊字符（如:、{、}等）需要转义；使用双引号时，可以包含特殊字符和变量插值（使用${}）；使用单引号时，字符串中的特殊字符不会被转义。

布尔值：YAML中的布尔值可以使用true/false（小写）或True/False（大写）表示，但推荐使用小写形式以保持一致性。

空值：YAML中的空值可以使用null或~表示。

锚点与别名：YAML支持锚点（anchors）和别名（aliases），允许在文件中重用配置片段。

2. 支持的数据结构

标量（Scalar）：单个值，如字符串、整数、浮点数和布尔值。

序列（Sequence）：一组有序的值，也称为列表（list）。使用-符号表示列表项。

映射（Mapping）：一组键值对，也称为字典（dictionary）或哈希（hash）。使用:符号分隔键和值，键和值之间可以有空格。

复合结构：映射和序列可以嵌套使用，形成复杂的数据结构。

3. 样例文件（config.yaml）

# 这是一个复杂的YAML配置文件示例# 定义一个列表,包含多个字典servers:- name: web_server ip: 192.168.1.10 roles:- web- cache settings:max_connections: 1000 timeout: 30s- name: db_server ip: 192.168.1.20 roles: [db, backup]settings:max_connections: 500 backup_frequency: daily

# 定义一个字典,包含嵌套字典和列表network:dns_servers:- 8.8.8.8- 8.8.4.4 default_gateway: 192.168.1.1 subnets:office:cidr: 192.168.1.0/24 dhcp_enabled: true lab:cidr: 10.0.0.0/8 dhcp_enabled: false vlan: 10

4. 特点与使用场景

YAML文件以键值对和嵌套结构著称，易于人类阅读。常用于复杂配置的存储，如Docker Compose文件。适用于需要层次结构配置的场景。

5. 解析代码

import yaml


# 读取并解析YAML文件with open('config.yaml', 'r') as file:config = yaml.safe_load(file)
# 获取配置（示例）
server_list = config['servers']network_config = config['network']
# 解析输出（示例）
for server in server_list:print(f"Server name: {server['name']}") print(f"IP address: {server['ip']}") print(f"Roles: {', '.join(server['roles'])}") print(f"Settings: max_connections: {server['settings']['max_connections']}") print(f"timeout: {server['settings']['timeout']}") print()

print(f"DNS Servers: {', '.join(network_config['dns_servers'])}") print(f"Default Gateway: {network_config['default_gateway']}") print(f"Subnet office: CIDR: {network_config['subnets']['office']['cidr']}") print(f"DHCP Enabled: {network_config['subnets']['office']['dhcp_enabled']}") print(f"Subnet lab: CIDR: {network_config['subnets']['lab']['cidr']}") print(f"DHCP Enabled: {network_config['subnets']['lab']['dhcp_enabled']}") print(f"VLAN: {network_config['vlan']}")

6. 解析说明

使用yaml.safe_load()方法读取并解析YAML文件，将配置数据加载到Python字典中。

通过字典访问方式遍历列表和嵌套字典，打印出配置信息。

列表项使用for循环遍历，字典项使用.items()方法遍历键值对。

注意处理嵌套结构和条件判断（如检查字典中是否包含某个键）。

三、JSON配置文件

1. 样例文件（config.json）

{"database": {"host": "localhost","port": 3306,"username": "admin","password": "123456"},"smtp": {"server": "smtp.gmail.com","port": 587,"username": "user@gmail.com","password": "password"}}

2. 特点与使用场景

JSON文件结构清晰，易于机器解析。常用于Web开发中的配置存储。适用于需要跨语言共享配置的场景。

3. 解析代码

import json


# 读取并解析JSON文件with open('config.json', 'r', encoding='utf-8') as file:config = json.load(file)
# 获取配置database_host = config['database']['host']smtp_server = config['smtp']['server']

print(f"Database host: {database_host}") print(f"SMTP server: {smtp_server}")

4. 代码解释

使用json.load()方法读取并解析JSON文件。

通过字典方式访问配置。

四、TOML配置文件

1. 样例文件（pyproject.toml）

[database]host = "localhost"port = 3306 username = "admin"password = "123456"

[smtp]server = "smtp.gmail.com"port = 587 username = "user@gmail.com"password = "password"

2. 特点与使用场景

TOML文件结构简洁，易于人类阅读。常用于Python项目的元数据、依赖项和工具配置。

3. 解析代码

Python标准库不直接支持TOML文件的解析，但可以使用第三方库tomllib（Python 3.11及以上版本）或toml（第三方库）。

以toml库为例：

import toml


# 读取并解析TOML文件with open('pyproject.toml', 'r') as file:config = toml.load(file)
# 获取配置database_host= config['database']['host']smtp_server = config['smtp']['server']

print(f"Database host: {database_host}") print(f"SMTP server: {smtp_server}")

4.代码解释

使用toml.load()方法读取并解析TOML文件。

通过字典方式访问配置。

五、XML配置文件

1.样例文件（config.xml）

localhost 3306 admin 123456 smtp.gmail.com 587 user@gmail.com password

2.特点与使用场景

XML文件结构严格，具有自描述性，适合存储复杂的、层次分明的配置信息。常用于企业级应用和Web服务的配置。

3.解析代码

import xml.etree.ElementTree as ET


#解析XML文件tree = ET.parse('config.xml') root = tree.getroot()
#获取配置database_host = root.find('database/host').text smtp_server = root.find('smtp/server').text

print(f"Database host: {database_host}") print(f"SMTP server: {smtp_server}")

4.代码解释

使用xml.etree.ElementTree模块解析XML文件。

通过find()方法定位到具体的XML元素，并获取其文本内容。

总结不同的配置文件格式各有优缺点，选择哪种格式主要取决于具体的应用场景和需求。INI文件结构简单，适合存储简单的键值对配置；YAML文件易于人类阅读，适合存储复杂的层次结构配置；JSON文件结构清晰，易于机器解析，适合跨语言共享配置；TOML文件结构简洁，易于人类阅读，常用于Python项目的配置；XML文件结构严格，具有自描述性，适合存储复杂的配置信息。在Python中，可以使用相应的库来解析这些配置文件，从而方便地读取和使用配置信息。

以上就是Python中配置文件的全面解析与使用的详细内容，更多关于Python配置文件的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:Python不同版本实现配置文件加密Python使用PyYAML库进行配置文件管理Python中使用YAML文件进行配置文件管理Python解析toml配置文件的方法分享Python实现解析yaml配置文件的示例详解