本文详解如何在 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）不会自动初始化：
立即学习“Python免费学习笔记（深入）”；
from ConfigHandler import ConfigHandler # ✅ 正确：创建实例 → 触发 __init__ → 打印日志、加载配置 config = ConfigHandler() # ✅ 属性直接访问（由 JSON 字段自动映射） print(config.a) # 输出: 1 print(config.b) # 输出: 2 print(config.c) # 输出: "Mark" # ❌ 错误：ConfigHandler 本身不是实例，不执行 __init__ # config = ConfigHandler # 不会打印任何内容，也不加载配置
? 进阶建议：
- 若需全局唯一配置（单例模式），可在类中添加 @classmethod 或使用模块级变量；
- 对敏感配置（如密码），建议结合环境变量或加密存储，切勿将密钥明文写入 config.json 并提交至版本库；
- 可扩展支持多格式（YAML/TOML）或层级合并（如 base.json + dev.json）。
总结：配置加载的核心在于显式实例化，而非静态引用；同时务必加入路径校验、异常处理与编码声明，确保代码在不同环境下的稳定性和可维护性。
