Python如何读取配置文件？，Python读取配置文件的方法

Python读配置文件：核心结论与最佳实践

Python项目中，配置文件是连接代码与运行环境的桥梁，最佳实践是：优先使用 YAML 或 TOML 作为配置文件格式，配合标准库或轻量级第三方库进行读取，并通过环境变量覆盖敏感信息，这样既能保证代码的可移植性，又能兼顾安全性与可维护性，以下从格式选择、读取方式、进阶技巧和实战经验四个层面展开。

为什么需要配置文件

将配置硬编码在代码中会导致：

• 环境切换时需修改代码
• 敏感信息泄露风险
• 维护成本高

配置文件将可变参数抽取出来，使同一份代码可部署到开发、测试、生产环境,只需更换配置文件即可。

主流配置文件格式与Python读取方案

INI 格式（标准库 configparser）

适合简单项目,层次结构清晰。

import configparser
config = configparser.ConfigParser()
config.read('config.ini')
db_host = config['database']['host']

优点：Python内置，无需安装第三方库。
缺点：不支持嵌套结构,值类型默认全为字符串。

JSON 格式（标准库 json）

通用性强,但缺乏注释支持。

import json
with open('config.json') as f:
    config = json.load(f)

优点：跨语言通用，解析速度快。
缺点：不能写注释,文件较大时可读性差。

YAML 格式（第三方库 PyYAML 或 ruamel.yaml）

推荐用于生产环境，支持注释、复杂嵌套、多文档。

import yaml
with open('config.yaml') as f:
    config = yaml.safe_load(f)

优点：可读性极高，支持锚点、别名等高级特性。
缺点：需安装 PyYAML，安全加载时需使用 safe_load。

TOML 格式（第三方库 toml 或 tomli）

新兴格式，被 Python 官方打包工具采用。

import tomllib  # Python 3.11+ 内置
with open('config.toml', 'rb') as f:
    config = tomllib.load(f)

优点：语法明确，类型原生支持，官方标准。
缺点：生态较新,第三方库版本需留意。

环境变量（标准库 os）

适合动态配置和敏感信息。

import os
db_password = os.getenv('DB_PASSWORD', 'default')

优点：与容器化、云平台天然集成。
缺点：值全为字符串,复杂结构需额外编码。

读配置文件的进阶技巧

分层加载与优先级

常见做法：默认配置 → 环境变量 → 命令行参数，后覆盖前。
示例：先读取 config.yaml 中的默认值,再通过环境变量覆盖特定字段。

校验与默认值

使用 pydantic 或 dataclasses 将配置解析为强类型对象,自动校验类型和必填项。

from pydantic import BaseSettings
class Settings(BaseSettings):
    db_host: str = "localhost"
    db_port: int = 5432
    debug: bool = False
    class Config:
        env_file = ".env"

这样既保证了类型安全,又支持从环境变量自动注入。

敏感信息处理

切勿将密码、密钥直接写入配置文件，应使用环境变量、Vault 服务或云厂商的密钥管理服务，在代码中只读取占位符,实际值从安全渠道获取。

酷番云实战经验：云环境下的配置管理

在酷番云服务器上部署 Python 应用时,我们推荐以下方案：

1. 使用环境变量注入：在酷番云控制台为实例设置自定义环境变量，应用启动时通过 os.getenv 读取，例如数据库密码、API Key 等敏感信息，既不会出现在代码仓库,也方便在云控制台统一管理。
2. 挂载配置文件：将配置文件存放于云硬盘或对象存储中，启动时挂载到容器或服务器的指定路径,代码无需修改即可读取。
3. 结合配置中心：对于微服务架构，可使用酷番云提供的配置管理服务，通过 SDK 或 HTTP 接口动态拉取配置，实现配置热更新,无需重启应用。

案例：某客户在酷番云上部署 Dify 应用，将大模型 API Key 通过环境变量传入，而其他业务参数（如日志级别、数据库连接池大小）使用 YAML 文件管理，通过酷番云对象存储挂载实现多节点共享配置文件，此举既保障了密钥安全,又简化了集群配置同步。

独立见解：配置对象化与类型安全

很多开发者直接使用字典访问配置，但这样容易因拼写错误或类型误用导致运行时异常。推荐将配置封装为数据类（dataclass）或使用 Pydantic 的 BaseSettings，配合 IDE 自动补全和类型检查，将错误提前暴露，将配置文件的读取逻辑单独封装为一个模块，只暴露一个 get_settings() 函数，统一入口，便于测试和 mock。

相关问答

问题1：我的项目应该选择哪种配置文件格式？
回答：取决于项目规模和团队习惯，小型脚本或工具可使用 INI 或 JSON，无需额外依赖，中大型项目推荐 YAML（可读性强）或 TOML（Python 生态原生支持），如果容器化部署，优先考虑环境变量 + 一种结构文件（如 YAML）的组合,兼顾灵活与安全。

问题2：如何安全地在代码中读取数据库密码等敏感信息？
回答：绝对不要硬编码或明文存储在配置文件中，推荐做法：

• 在开发环境使用 .env 文件（确保加入 .gitignore）
• 在生产环境通过环境变量传入，例如在酷番云控制台设置环境变量
• 使用密钥管理服务（如 HashiCorp Vault、云厂商的 Secrets Manager）动态获取
• 在代码中只引用环境变量名，不存储实际值

欢迎分享你的经验

你在实际项目中使用过哪些配置文件格式？遇到过哪些坑？欢迎在评论区留言交流,一起探讨更优雅的配置管理方案。