本文目录导读：
SyntaxError: invalid syntax（语法错误）NameError: name ‘xxx’ is not defined（名称未定义）TypeError: unsupported operand type(s) for +: ‘int’ and ‘str’（类型错误）IndexError: list index out of range（列表索引越界）KeyError: ‘xxx’（字典键错误）ValueError: invalid literal for int() with base 10: ‘abc’（值错误）AttributeError: ‘int’ object has no attribute ‘append’（属性错误）FileNotFoundError: [Errno 2] No such file or directory: ‘xxx.txt’（文件未找到）ModuleNotFoundError: No module named ‘requests’（模块未找到）IndentationError: unexpected indent（缩进错误）- 总结：如何高效解决 Python 报错？
Python的报错信息通常很清晰,理解并掌握常见错误的解决方法是进阶的关键，以下我整理了10个最常见、最让新手头疼的报错案例，并附上原因分析和解决方案。
SyntaxError: invalid syntax（语法错误）
这是最基础的错误,通常是因为漏了符号、括号不匹配或使用了Python不认识的语法。
-
场景1：漏了冒号
# 错误 if True print("Hello") # 正确 if True: print("Hello") -
场景2：中英文符号混用
# 错误 (使用了中文括号） print（“Hello”） # 正确 print("Hello") -
场景3：Python 2 的语法用在 Python 3
# 错误 (Python 2) print “Hello” # 正确 (Python 3) print(“Hello”)
NameError: name ‘xxx’ is not defined（名称未定义）
你使用了一个之前没有定义过的变量、函数或模块。
-
场景1：变量名拼写错误
name = “Alice” # 错误: NameError: name ‘nam’ is not defined print(nam) # 正确 print(name)
-
场景2：忘记导入模块就使用
# 错误: NameError: name ‘math’ is not defined result = math.sqrt(16) # 正确 import math result = math.sqrt(16)
-
场景3：函数调用顺序错误
# 错误: 函数还没定义就调用了 my_func() # 正确: 先定义后调用 def my_func(): print(“Hello”) my_func()
TypeError: unsupported operand type(s) for +: ‘int’ and ‘str’（类型错误）
对不支持的数据类型进行了操作,比如数字加字符串。
-
场景1：数字和字符串拼接
age = 25 # 错误: TypeError: can only concatenate str (not “int”) to str print(“I am ” + age + ” years old”) # 正确: 用 str() 转换，或使用 f-string print(“I am ” + str(age) + ” years old”) print(f“I am {age} years old”) -
场景2：NoneType 无法调用方法
data = None # 错误: TypeError: ‘NoneType’ object is not callable data.append(1) # 正确: 先检查是否为 None if data is not None: data.append(1)
IndexError: list index out of range（列表索引越界）
你尝试访问列表中不存在的索引位置。
-
场景1：索引从0开始，但用了1
my_list = [10, 20, 30] # 错误: 索引 3 不存在 (只有 0,1,2) print(my_list[3]) # 正确 print(my_list[2]) # 输出 30
-
场景2：循环时列表空了
# 错误: 通常发生在 while 循环中忘记检查列表长度 my_list = [] my_list[0]
KeyError: ‘xxx’（字典键错误）
你尝试访问字典中不存在的键。
-
场景1：键名拼写错误
user = {“name”: “Bob”, “age”: 30} # 错误: KeyError: ‘Name’ print(user[“Name”]) # 正确: 键名区分大小写 print(user[“name”]) -
场景2：不确定键是否存在
# 推荐做法: 使用 .get() 方法, 找不到时返回 None 或默认值 user = {“name”: “Bob”} age = user.get(“age”) # 返回 None age = user.get(“age”, 18) # 返回 18 (默认值)
ValueError: invalid literal for int() with base 10: ‘abc’（值错误）
你尝试将一个无法转换的内容转换为数字。
- 场景：用户输入了非数字字符
# 错误: 输入 ‘abc’ 或 ‘12.5’ 都会报错 num = int(input(“请输入一个整数: ”)) # 正确: 使用 try-except 捕获异常 try: num = int(input(“请输入一个整数: ”)) except ValueError: print(“输入无效，请输入一个整数。”)
AttributeError: ‘int’ object has no attribute ‘append’（属性错误）
你调用了对象不存在的方法或属性。
- 场景：把整数当列表用
num = 10 # 错误: int 没有 append 方法 num.append(5) # 正确: 需要用列表 my_list = [] my_list.append(5)
FileNotFoundError: [Errno 2] No such file or directory: ‘xxx.txt’（文件未找到）
你试图打开或操作一个不存在的文件。
- 场景：路径错误或文件名拼错
# 错误: 文件 ‘data.txt’ 不存在于当前目录 with open(“data.txt”, “r”) as f: content = f.read() # 解决: 检查文件路径, 或使用 os.path.exists() 先判断 import os if os.path.exists(“data.txt”): with open(“data.txt”, “r”) as f: content = f.read()
ModuleNotFoundError: No module named ‘requests’（模块未找到）
你尝试导入一个没有安装的第三方库。
- 解决：安装这个模块
pip install requests
- 注意： 如果你同时有 Python 2 和 3，可能需要用
pip3。
IndentationError: unexpected indent（缩进错误）
Python 通过缩进来表示代码块，不统一的缩进（混用空格和 Tab）会报错。
-
场景：代码块缩进不一致
def my_func(): print(“Hello”) # 用了 2 个空格 print(“World”) # 用了 4 个空格 (缩进不一致) -
最佳实践：
- 统一使用 4个空格 缩进。
- 在 IDE (如 PyCharm, VS Code) 中设置 “将 Tab 转换为空格”。
如何高效解决 Python 报错？
- 看最后一行： 错误类型和简短描述是最关键的信息。
- 看 Traceback（回溯）： 从下往上看，找到
File “xxx.py”, line N，那里会指出你代码哪一行出了问题。 - 搜索引擎： 直接复制
TypeError: can only concatenate str (not “int”) to str到 Google 或 Stack Overflow 上搜索，通常前几个结果就能告诉你答案。
掌握这些常见的错误模式,能让你节省大量调试时间。
标签： Python报错