（从基础、规范写法、常用异常、自定义异常、实操避坑 全整理，适配你的代码习惯）
一、异常核心基础概念
- 什么是异常
代码运行时出现的错误、逻辑非法、参数不合法等，导致程序强制终止的报错，就是异常。
- 主动抛出异常关键字
只有raise是 Python主动抛异常的关键字。
- 两种报错本质区别
- 写法：raise "错误信息"
❌ 非法写法，不是业务异常，是 Python 语法报错：TypeError: exceptions must derive from BaseException
- 写法：Exception("错误信息")
✅ 标准规范，主动抛出业务异常，可被正常捕获、识别。
二、主动抛出异常 标准写法
1. 万能通用写法（日常开发首选）
不知道该用什么具体异常类型时，统一用顶层父类Exception，全覆盖、不报错、好维护。
# 万能格式 raise Exception("自定义错误提示文本")2. 规范细分内置异常（追求严谨时使用）
内置异常是 Python 自带分类，对应不同错误场景：
- AttributeError：属性不存在（适配你的 Config 配置类）
- ValueError：数值 / 参数非法
- KeyError：字典键不存在
- TypeError：数据类型错误
示例：
# 属性不存在专用 raise AttributeError("配置类无此属性") # 数值错误专用 raise ValueError("年龄超出合法范围")三、异常捕获基础try...except
作用：拦截异常，防止程序崩溃，优雅处理错误。
try: # 可能出错的代码 Config.set_attr("test", 123) except Exception as e: # 捕获异常并打印信息 print("执行失败：", e)四、异常的传递与复用
- 重新抛出原有异常
try: 1 / 0 except: raise # 原样抛出上层异常，不修改信息- 异常链式改写（极少用，了解即可）
五、自定义异常类（重点理解）
1. 核心理解
- 所有异常最终都继承自BaseException；
- 自定义异常，只需要继承Python内置Exception类；
- 作用：区分项目业务错误、系统错误，让报错分类更清晰，方便后期排查。
2. 自定义异常 基础语法
# 自定义业务异常基类 class BusinessError(Exception): """项目所有业务异常的父类""" pass # 细分场景异常 class ConfigAttrError(BusinessError): """配置类属性不存在异常""" pass class ParamError(BusinessError): """参数非法异常""" pass3. 自定义异常 实战使用
class Config: @classmethod def set_attr(cls, name, value): if not hasattr(cls, name): # 抛自定义异常 raise ConfigAttrError(f"配置项【{name}】不存在")4. 自定义异常进阶（自定义错误信息）
class ConfigAttrError(Exception): def __init__(self, msg: str): self.msg = msg super().__init__(self.msg) # 使用 raise ConfigAttrError("禁止修改私有配置属性")5. 自定义异常的价值
- 区分系统异常和自己项目业务异常；
- 捕获时可以精准拦截：
try: Config.set_attr("xxx", 1) except ConfigAttrError: # 只处理配置错误 print("配置校验失败") except Exception: # 处理其他所有错误 print("系统未知错误")- 大型项目、SDK、库开发（如你的LhPyQt5）必备，代码更规范。
六、结合你代码的实操标准示例
优化后 Config 配置类异常写法
# 自定义配置专属异常 class ConfigError(Exception): pass class Config: is_generate_manager_account = False @classmethod def set_attr(cls, name: str, value): if not hasattr(cls, name): # 规范抛异常 raise ConfigError(f"当前配置类不存在属性：{name}") setattr(cls, name, value)七、关键避坑总结
- ❌ 禁止：raise "文字"
- ✅ 强制：raise异常类(提示文字)
- 日常开发：优先raise Exception("提示")够用
- 精细化开发：使用对应内置异常 / 自定义异常
- 异常不要滥用：正常业务逻辑不要靠异常控制，只用于「非法、错误场景」
八、极简背诵口诀
- 抛异常必带异常类，不能直接抛字符串；
- 通用报错用 Exception，细分场景用内置异常；
- 自定义异常继承 Exception，用于业务分类；
- 异常用来兜底防崩溃，不用来替代正常判断。
