Python 中通过类初始化自动加载 JSON 配置文件的完整实践指南_技术教程

本文详解如何在 python 类的 `__init__` 方法中安全加载 json 配置文件，并将其字段直接映射为实例属性，实现简洁、可复用的配置管理。

在 Python 应用开发中，将配置与代码分离是最佳实践之一。使用 JSON 文件存储配置（如数据库地址、API 密钥、超时设置等）既直观又易于维护。下面介绍一种轻量但健壮的实现方式：通过自定义类在实例化时自动加载并解析 JSON 配置。

首先，完善 ConfigHandler 类——需注意路径安全性、异常处理和资源释放：

import os
import json

class ConfigHandler:
    CONFIG_FILE = "config.json"  # 推荐使用相对路径，避免硬编码根路径

    def __init__(self):
        print("Initializing config...")
        if not os.path.exists(self.CONFIG_FILE):
            raise FileNotFoundError(f"Configuration file '{self.CONFIG_FILE}' not found.")

        try:
            with open(self.CONFIG_FILE, "r", encoding="utf-8") as f:
                config_data = json.load(f)

            # 安全地将字典键值映射为实例属性（避免覆盖内置方法）
            for key, value in config_data.items():
                if isinstance(key, str) and key.isidentifier():
                    setattr(self, key, value)
                else:
                    print(f"Warning: Skipping invalid config key '{key}' (not a valid identifier)")
            print("Configuration loaded successfully.")
        except json.JSONDecodeError as e:
            raise ValueError(f"Invalid JSON in '{self.CONFIG_FILE}': {e}")
        except Exception as e:
            raise RuntimeError(f"Failed to load config: {e}")

✅ 关键改进说明：

使用 with open(...) 确保文件正确关闭；
添加 encoding="utf-8" 显式指定编码，避免中文乱码；
检查 key.isidentifier() 防止非法属性名（如 "db-url" 无法作为 obj.db-url 访问）；
抛出明确异常，便于调试和上层捕获；
CONFIG_FILE 改为相对路径（如 "config.json"），更符合项目结构惯例（可配合 os.path.join(os.path.dirname(__file__), ...) 进一步增强鲁棒性）。

在主应用中，必须创建实例才能触发 __init__ —— 类属性（static）不会自动初始化：

from ConfigHandler import ConfigHandler

# ✅ 正确：创建实例 → 触发 __init__ → 打印日志、加载配置
config = ConfigHandler()

# ✅ 属性直接访问（由 JSON 字段自动映射）
print(config.a)  # 输出: 1
print(config.b)  # 输出: 2
print(config.c)  # 输出: "Mark"

# ❌ 错误：ConfigHandler 本身不是实例，不执行 __init__
# config = ConfigHandler  # 不会打印任何内容，也不加载配置