Python自定义异常必须继承Exception或其子类，否则无法被except Exception捕获；抛出时须用raise MyError("msg")而非raise MyError；需实现__init__并调用super().__init__(msg)确保可打印；推荐统一定义在errors.py中，明确处理层级与携带字段。
Python自定义异常必须继承 Exception，不能只写个空类
直接写 class MyError: 是无效的——它不会被 except Exception: 捕获，也不具备异常行为（比如没 __str__、不能被 raise 正常传播）。必须显式继承 Exception 或其子类（如 ValueError）。
- 推荐继承
Exception：语义清晰，业务异常就该是顶层异常的子类 - 避免继承
BaseException：那是系统级异常（如SystemExit）的父类，业务代码不该碰 - 如果语义贴近已有类型（比如参数错得离谱），可继承
ValueError或TypeError，但要确保逻辑合理，别为了“省事”乱继承
抛出时用 raise MyError("msg")，不是 raise MyError
漏掉括号或参数是高频错误。写成 raise MyError 会抛出 TypeError: exceptions must derive from BaseException —— 因为 Python 把类本身当成了要抛出的对象，而类不是异常实例。
- 正确写法永远是
raise MyError("用户未登录")或raise MyError()（空参也行，但建议带信息） - 如果需要传多个上下文字段（比如错误码、trace_id），在
__init__里接收并存为实例属性，别堆在字符串里解析 - 不要在
raise后加from None除非真想屏蔽原始异常链；默认保留链路对调试更重要
加 __init__ 是为了结构化携带数据，不是为了“看起来专业”
纯消息字符串够用时，其实可以不写 __init__（Python 会自动继承父类的）。但一旦你需要把错误码、HTTP 状态码、原始输入等附带信息传出去，就必须自己实现初始化逻辑，并调用 super().__init__(...) 确保消息能被打印出来。
class UserNotFoundError(Exception):
def __init__(self, user_id: int, source: str = "db"):
self.user_id = user_id
self.source = source
super().__init__(f"User {user_id} not found in {source}")
-
super().__init__(...)这一行不能少，否则str(exc)为空，日志里只剩类名 - 实例属性（如
self.user_id）方便上层做条件判断：if isinstance(e, UserNotFoundError) and e.user_id == 123: - 别在
__init__里做耗时操作（比如查数据库、发 HTTP 请求）——异常构造应轻量
捕获时用 except MyError: 要小心模块路径和重名
自定义异常类如果定义在不同文件、不同包里，except 时容易因导入路径不一致导致捕获失败。更隐蔽的问题是：两个同名类（比如都叫 ValidationError）来自不同模块，except ValidationError: 只会捕获你当前 import 的那个。
立即学习“Python免费学习笔记（深入）”；
- 始终用完整路径导入并捕获：
from myapp.errors import UserNotFoundError，然后except UserNotFoundError: - 避免在多处重复定义同名异常类；统一收口到
errors.py或类似模块 - 如果要用通配捕获（比如
except Exception:），记得自定义异常必须继承Exception，否则会被漏掉
except，或者全扔给顶层兜底，结果错误码、上下文全丢光。写之前先想清楚：这个异常预期在哪一层被捕获？需要传递哪些机器可读的字段？这些比继承语法重要得多。 
