错误类型

是否直接报错

错误提示特征

典型场景

解决思路

记忆口诀

语法错误

是

包含 SyntaxError 或 IndentationError

括号 / 引号不配对、缩进错误、关键字拼写错

按报错行号检查符号配对和缩进格式

语法错误别慌张，报错位置看前方，符号配对要检查，缩进对齐不能忘

运行时错误

是

包含具体错误类型（如 ZeroDivisionError）

除数为零、索引越界、类型不匹配等运行期问题

根据错误描述检查数据合法性（如除数是否为零、索引是否超限）

运行错误别着急，追踪信息看仔细，错误类型和描述，找到问题好解决

逻辑错误

否（结果异常）

无明确报错，结果不符合预期

循环次数错误、条件判断逻辑漏洞、算法逻辑错误

通过打印中间变量或调试工具追踪数据变化

逻辑错误要细心，中间结果多打印，调试工具来帮忙，逐步排查没问题

错误子类

错误提示示例

错误原因

代码示例（错误 vs 正确）

解决工具

括号不配对

SyntaxError: '(' was not closed

括号 / 引号未闭合（如 ( [ { """ 等）

print("hello world # 错误（少右引号）

print("hello world") # 正确

代码编辑器的括号高亮功能

缩进错误

IndentationError: unindent does not match outer level

函数 / 循环 / 条件语句的缩进层级混乱

if True:

print("hi") # 错误（少缩进）

if True:

print("hi") # 正确

使用编辑器自动缩进（Tab 键 / 4 空格）

关键字错误

SyntaxError: invalid syntax

关键字大小写错误或拼写错误（如 Print 代替 print）

Print("hello") # 错误<br>print("hello") # 正确

记住 Python 关键字列表（全小写）

中英文符号混用

SyntaxError: invalid character in identifier

误用中文标点（如中文逗号、冒号）

print('hello'，'world') # 错误（中文逗号）<br>print('hello', 'world') # 正确

检查标点符号是否为英文半角

错误子类

错误提示示例

核心问题

代码示例（错误 vs 正确）

预防技巧

除以零错误

ZeroDivisionError: division by zero

除数为零

c = 10 / 0 # 错误

if b != 0:

c = a / b # 正确

除法前添加 if 除数 != 0 校验

索引错误

IndexError: list index out of range

访问不存在的索引（列表 / 字符串 / 元组）

list = [1,2,3]

print(list[3]) # 错误（索引3超出范围）

print(list[len(list)-1]) # 正确（取最后一个元素）

用 len(容器) 获取长度后计算合法索引

类型错误

TypeError: unsupported operand type(s) for +: 'int' and 'str'

操作符作用于不支持的类型（如数字 + 字符串）

result = 5 + "3" # 错误result = 5 + int("3") # 正确

操作前检查类型，用 int()/str()/float() 转换

名称错误

NameError: name 'x' is not defined

引用未定义的变量或函数

print(my_var) # 错误（变量未定义）my_var = 10

print(my_var) # 正确

使用变量前先赋值，检查拼写是否正确

键错误

KeyError: 'key'

访问字典中不存在的键

d = {'a':1}

print(d['b']) # 错误

if 'b' in d:

print(d['b'])

else:

print('Key not found') # 正确

使用 in 运算符或 get() 方法检查键是否存在

错误场景

典型问题

排查方法

示例（错误 vs 正确）

调试工具

循环次数错误

想算 1-10 的和，结果少加 10

在循环内打印 i 和中间结果

for i in range(1,10): # 错误（只到9）

for i in range(1,11): # 正确

用 print(i, sum) 打印中间值

条件判断错误

成绩≥60 算及格，代码写成 if score > 60

测试边界值（如 60 分是否被正确判断）

if score >= 60: # 正确

if score > 60: # 错误（漏掉60分）

使用编辑器断点调试（逐行执行看变量变化）

算法逻辑错误

排序算法结果混乱

打印每一步排序后的列表状态

冒泡排序内层循环未正确比较相邻元素，导致排序错误

PyCharm/VSCode 自带调试器（设置断点单步执行）

步骤

操作要点

核心价值

示例（以除以零错误为例）

1. 看类型

快速定位错误大类（如 ZeroDivisionError 属于运行时错误）

缩小排查范围（语法错误 / 运行时错误 / 逻辑错误）

看到 ZeroDivisionError 就知道是运行时的除数问题

2. 找位置

读取 File "xxx.py", line X 确定报错文件和行号

直接定位到代码中的问题行（可能是该行或其依赖的代码）

报错行是 line 3: c = a / b，重点检查该行的 b 变量

3. 读描述

理解错误详情（如 division by zero 表示除数为零）

明确具体问题（不是所有运行时错误都叫「除以零」！）

知道是因为 b=0 导致除法失败，而不是索引问题

4. 查上下文

检查报错行的上下游代码（如 b 是从哪里来的？是否可能为零？）

避免「头痛医头」（比如上游代码给 b 赋值为 0 未校验）

发现上游 b = 0 是固定值，没有做非零校验，应添加 if b != 0 处理

5. 改代码

根据分析修改后，重新运行并验证结果

确保修改有效（可能需要多次调试）

修改后代码：if b != 0: c = a / b else: c = 0，运行不再报错

错误类型

错误代码

报错信息关键部分

分析过程

修复方案

语法错误

if True:

print("hi")

IndentationError: expected indented block

if 语句后需缩进代码块，print 未缩进

添加 4 个空格缩进：

if True:

print("hi")

运行时错误

list = [1,2,3]

print(list[3])

IndexError: list index out of range

列表索引最大为 2（0 开始），访问索引 3 越界

改为合法索引：print(list[2]) 或用 len(list)-1 动态获取

逻辑错误

sum = 0

for i in range(10):

sum -= i

无报错，结果为 -45（预期 45）

误将 += 写成 -=，且 range(10) 是 0-9（少加 10）

修正为：

sum = 0

for i in range(1,11):

sum += i

名称错误

print(my_var)

NameError: name 'my_var' is not defined

变量 my_var 未定义

先赋值再使用：

my_var = 10

print(my_var)

键错误

d = {'a':1}

print(d['b'])

KeyError: 'b'

字典 d 中不存在键 'b'

检查键是否存在：

if 'b' in d:

print(d['b'])

else:

print('Key not found')

工具

适用场景

核心功能

代码示例

优势

try-except

捕获已知异常，避免程序崩溃

捕获特定类型的异常并处理

try:

result = 10 / 0

except ZeroDivisionError:

print("除数不能为零")

灵活处理异常，程序继续执行

traceback

查看详细错误堆栈信息

打印完整的错误调用栈和上下文

import traceback

try:

1/0

except:

traceback.print_exc()

定位深层嵌套调用中的错误

logging

记录错误信息到日志文件

持久化保存错误信息，便于后续分析

import logging

logging.basicConfig(filename='error.log', level=logging.ERROR)

try:

1/0

except:

logging.error("发生错误", exc_info=True)

适合生产环境，不影响程序正常运行

pdb 调试器

复杂逻辑错误排查

逐行执行代码，查看变量值

import pdb

pdb.set_trace()

a = 1

b = 0

c = a / b

动态调试，直观查看代码执行流程

断言 assert

验证关键逻辑正确性

强制检查条件，不满足则触发错误

assert 1 == 2, "数学定律被打破！"

快速发现隐藏的逻辑错误，提高代码健壮性

错误类型

报错特征

解决优先级

常用工具

语法错误

红色报错，带 SyntaxError

最高（无法运行）

代码编辑器语法高亮

运行时错误

红色报错，带具体错误类型

次高（运行中断）

错误描述 + 变量检查

逻辑错误

无报错，结果异常

中等（需主动排查）

print() 调试 + 断点调试