python错误国际化需拦截异常并重写提示，保持原类型与堆栈；通过自定义基类定义多语言模板，用contextvar动态管理请求级语言偏好，出口处统一格式化，支持外部资源文件分离。
Python 默认的错误信息是英文的，直接面向终端用户时体验不好。要实现错误信息国际化，核心思路是不修改异常类本身，而是拦截、捕获并重写错误提示内容，同时保持原有异常类型和堆栈不变，便于调试和逻辑判断。
用自定义异常基类统一管理错误码与多语言消息
定义一个带错误码（code）和多语言模板（messages）的基类，不同语言通过字典映射填充：
- 每个子类对应一类业务错误，如 UserNotFoundError、InsufficientBalanceError
- 在类属性中声明多语言消息模板，例如：
messages = {"zh": "用户 {user_id} 不存在", "en": "User {user_id} not found"} - 实例化时传入参数（如 user_id），调用 format_message(lang) 动态生成本地化提示
运行时动态切换语言，避免全局状态污染
语言偏好应来自请求上下文（如 Web 请求头中的 Accept-Language）或用户配置，而非全局变量：
- 使用 contextvars.ContextVar 存储当前请求的语言标识，线程/协程安全
- 在中间件或入口函数中设置该变量，后续异常格式化自动读取
- 避免用 locale.setlocale()，它影响整个进程且非线程安全
捕获并重写异常提示，保留原始类型与 traceback
不建议覆盖 __str__ 或 __repr__，而应在日志、API 响应等出口处统一处理：
立即学习“Python免费学习笔记（深入）”；
- 对捕获到的异常，检查是否为自定义错误类，调用其 format_message(lang)
- 若不是，则 fallback 到原生 str(exc)，保证第三方库异常不受影响
- 返回 JSON 响应时，结构建议包含：code（机器可读错误码）、message（已翻译文本）、debug_info（仅开发环境显示原始 traceback）
补充：资源文件分离与热更新支持
消息模板量大后，建议从代码中抽离到外部文件：
- 使用 JSON 或 YAML 按语言分文件，如 errors/zh.json、errors/en.json
- 启动时加载进内存缓存，支持文件监听 + 重新加载（开发阶段可用 watchdog）
- 生产环境通常静态加载，无需实时热更，但需确保部署时语言包同步发布
