本文系统讲解 python 中两类核心错误——语法错误与运行时异常，涵盖错误信息解读、常见异常类型、try/except 基础用法，并延伸至异常类继承与自定义设计原则，助你构建健壮、可维护的错误处理逻辑。
本文系统讲解 python 中两类核心错误——语法错误与运行时异常，涵盖错误信息解读、常见异常类型、try/except 基础用法，并延伸至异常类继承与自定义设计原则，助你构建健壮、可维护的错误处理逻辑。
在 Python 开发中，正确识别和处理错误是编写可靠程序的关键能力。错误主要分为两类：语法错误（Syntax Errors） 和 异常（Exceptions）。二者本质不同，需区别对待。
一、语法错误：解析阶段即终止
语法错误又称解析错误（parsing errors），是 Python 解释器在编译源码为字节码时发现的结构问题，程序甚至无法开始执行。例如：
while True print('Hello world')
运行时将立即报错：
File "<stdin>", line 1
while True print('Hello world')
^
SyntaxError: invalid syntax</stdin>
注意：箭头 ^ 指向的是解释器检测到错误的位置，但真正的问题往往在前文——本例中缺失的是 while True: 后的冒号 :。此时需严格检查语句结构、括号匹配、冒号、缩进等基础语法要素。
二、异常：运行时发生的逻辑错误
即使语法完全正确，程序在执行过程中仍可能因非法操作触发异常（如除零、未定义变量、类型不匹配）。这类错误不会阻止程序启动，但若未捕获，会导致中断并输出完整的 traceback：
>>> 10 * (1 / 0) ZeroDivisionError: division by zero >>> '2' + 2 TypeError: can only concatenate str (not "int") to str >>> spam * 3 NameError: name 'spam' is not defined
每条 traceback 的最后一行明确指出异常类型（如 ZeroDivisionError）和具体原因（如 division by zero），这是定位问题的核心线索。
三、捕获与处理异常：try / except 实践
使用 try...except 可主动拦截特定异常，避免程序崩溃，并提供友好反馈或降级逻辑：
while True:
try:
x = int(input("请输入一个整数: "))
break
except ValueError:
print("输入无效！请重新输入一个整数。")
except KeyboardInterrupt:
print("\n用户已取消输入。")
break
✅ 最佳实践建议：
-
精准捕获：避免裸
except:，应明确指定异常类型（如except ValueError:），防止掩盖意外错误； - 多分支处理：按异常严重性或业务含义分层处理；
-
保留原始上下文：必要时用
raise重新抛出，或通过raise ... from e显式关联因果链（利用__cause__）。
四、自定义异常：语义化与可维护性的基石
当内置异常不足以表达业务语义时，应创建自定义异常类。Python 要求所有异常必须继承自 BaseException，但强烈推荐继承 Exception 类（而非直接继承 BaseException），以确保与标准异常行为一致：
class OrderNotFoundError(Exception):
"""订单不存在的业务异常"""
def __init__(self, order_id: int, message: str = "Order does not exist"):
self.order_id = order_id
self.message = message
super().__init__(self.message)
# 使用示例
def get_order_by_id(order_id: int) -> dict:
if not db.exists(order_id):
raise OrderNotFoundError(order_id)
return db.fetch(order_id)
# 调用方安全处理
try:
order = get_order_by_id(999)
except OrderNotFoundError as e:
logger.warning(f"订单 {e.order_id} 未找到：{e.message}")
raise HTTPException(status_code=404, detail=e.message)
⚠️ 关键注意事项：
- 自定义异常应清晰命名（推荐
*Error或*Exception后缀），并提供有意义的__doc__； - 构造函数中可封装业务字段（如
order_id），便于日志记录与监控； - 避免在异常中执行耗时或副作用操作；
- 在 Web 框架（如 FastAPI/Flask）中，通常需将自定义异常映射为 HTTP 响应，而非直接暴露给前端。
掌握语法错误的快速识别、异常的精准捕获，以及符合 Python 惯例的自定义异常设计，是进阶 Python 工程师的必备素养。始终牢记：好的错误处理不是掩盖问题，而是让问题更易发现、更易诊断、更易恢复。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
