Python案例怎么读取配置文件？

Python代码：

import yaml
with open('config.yaml', 'r') as f:
    config = yaml.safe_load(f)  # 安全加载，避免任意代码执行
# 列表和字典的混合访问
slave_hosts = [slave['host'] for slave in config['database']['slaves']]
print(f"从库列表: {slave_hosts}")

注意：始终使用 yaml.safe_load() 而非 yaml.load()，后者可能执行恶意代码。

案例4：环境变量模式（12-Factor App）

场景：云原生应用、Docker容器部署

这是Heroku和现代云平台推荐的方式,配置通过操作系统环境变量注入。

Python代码：

import os
# 从环境变量读取配置
db_host = os.getenv('DB_HOST', 'localhost')
db_port = int(os.getenv('DB_PORT', '5432'))
debug_mode = os.getenv('DEBUG', 'false').lower() == 'true'
# 使用python-dotenv支持.env文件（开发环境）
from dotenv import load_dotenv
load_dotenv()  # 加载.env文件
print(f"数据库地址: {db_host}:{db_port}")

.env文件示例：

DB_HOST=localhost
DB_PORT=5432
DEBUG=false
SECRET_KEY=my-secret-key

安全最佳实践：永远不要将.env文件提交到Git仓库（添加至.gitignore），生产环境通过K8s Secret或云平台管理实际变量。

案例5：多环境配置管理

场景：开发、测试、生产环境使用不同配置

方案：基础配置 + 环境覆盖

config_base.yaml：

database:
  host: localhost
  port: 5432
logging:
  level: DEBUG

config_prod.yaml：

database:
  host: prod-db.example.com
logging:
  level: WARNING

代码实现：

import yaml
import os
def load_config(env='dev'):
    with open(f'config_base.yaml', 'r') as f:
        config = yaml.safe_load(f)
    env_file = f'config_{env}.yaml'
    if os.path.exists(env_file):
        with open(env_file, 'r') as f:
            env_config = yaml.safe_load(f)
        # 深度合并（使用deepmerge库更可靠）
        config.update(env_config)
    return config
config = load_config('prod')
print(f"生产数据库: {config['database']['host']}")

案例6：配置热重载（Hot Reload）

场景：在应用运行过程中更新配置，无需重启服务

实现：使用文件监控 + 线程安全的重载

import time
import json
import threading
class ConfigWatcher:
    def __init__(self, filename, callback=None):
        self.filename = filename
        self.callback = callback
        self.config = {}
        self._last_mtime = 0
        self._stop = False
    def start(self):
        self._load_config()
        threading.Thread(target=self._watch, daemon=True).start()
    def _load_config(self):
        with open(self.filename, 'r') as f:
            self.config = json.load(f)
        if self.callback:
            self.callback(self.config)
    def _watch(self):
        while not self._stop:
            try:
                mtime = os.path.getmtime(self.filename)
                if mtime != self._last_mtime:
                    self._last_mtime = mtime
                    self._load_config()
            except Exception as e:
                print(f"监控异常: {e}")
            time.sleep(2)  # 检查间隔
    def get(self, key, default=None):
        return self.config.get(key, default)
    def stop(self):
        self._stop = True
# 使用示例
watcher = ConfigWatcher('config.json', 
    callback=lambda cfg: print(f"配置已更新：{cfg}"))
watcher.start()

案例7：加密配置的安全读取

场景：数据库密码、API密钥等敏感信息需要加密存储

方案：使用 cryptography 库对配置文件中的敏感字段加密

加密步骤（事先运行一次生成加密配置）：

from cryptography.fernet import Fernet
# 生成密钥并保存（需妥善保管）
key = Fernet.generate_key()
with open('secret.key', 'wb') as f:
    f.write(key)
# 加密密码
cipher = Fernet(key)
encrypted_pwd = cipher.encrypt(b'my_actual_password')
print(f"加密后的密码: {encrypted_pwd}")

运行时解密：

from cryptography.fernet import Fernet
# 读取密钥
with open('secret.key', 'rb') as f:
    key = f.read()
cipher = Fernet(key)
# 从配置文件中读取加密字段
encrypted_pwd = "gAAAAABm...（你的加密字符串）"
real_password = cipher.decrypt(encrypted_pwd.encode()).decode()
print(f"解密后的密码: {real_password}")

建议：密钥文件通过环境变量或云密钥管理服务（如AWS KMS、Azure Key Vault）注入，而非存储在代码仓库。

常见问题Q&A

Q1：配置文件应该放在项目的哪个位置？

A：建议遵循以下规范：

• 默认配置：项目根目录/config/default.xxx
• 环境覆盖：config/development.xxx, config/production.xxx
• 安全配置：通过环境变量或外部密钥服务注入

Q2：YAML缩进错误怎么办？

A：使用YAML lint工具检查，在VS Code中安装YAML Support插件或运行：

pip install yamllint
yamllint config.yaml

Q3：JSON不支持注释怎么办？

A：三种解决方案：

1. 使用JSON5格式（pyjson5库）
2. 在JSON中使用特殊字段作为注释（如 "__comment__": "这是注释"）
3. 使用HOCON格式（推荐，如pyhocon库）

Q4：配置文件变更时应用没有感知怎么办？

A：实现案例6的热重载功能，或使用云配置中心（如Consul、etcd）自动推送变更。

Q5：如何防止密码被硬编码在配置文件中？

A：三级方案：

1. 配置加密（案例7）
2. 环境变量替代（案例4）
3. 使用密钥管理服务（如HashiCorp Vault）

Q6：ORM框架如何优雅整合配置文件？

A：例如SQLAlchemy的配置示例：

from sqlalchemy import create_engine
config = yaml.safe_load(open('config.yaml'))
db_url = f"mysql+pymysql://{config['db']['user']}:{config['db']['pass']}@{config['db']['host']}/{config['db']['name']}"
engine = create_engine(db_url, echo=config.get('debug', False))

1. 选择格式按需求：INI适合简单配置，JSON适合Web，YAML适合复杂结构，TOML是现代Python项目的新标准。
2. 分离敏感信息：始终将密码、密钥等通过环境变量或加密文件管理。
3. 版本控制策略：默认配置可入库，环境特定配置和密码相关文件添加至.gitignore。
4. 错误弹性的读取：使用 fallback 默认值，处理文件不存在或解析异常。
5. 统一配置入口：建议封装一个 Config 类，提供 get(key, default) 的访问接口。

希望这7个案例能帮助你彻底掌握Python配置文件读取,从最基础的INI到企业级加密配置，每一步都考虑了实际开发中的痛点，如果你在项目中遇到特殊情况，欢迎在评论区交流。