Python新手常见错误及避坑技巧

Python看似简洁易上手，但新手常因忽略其独特设计（如强制缩进、作用域规则、默认参数机制、强类型约束和列表遍历限制）而频繁踩坑——从缩进错误、变量未定义，到可变默认参数的“记忆陷阱”、字符串数字混用报错，再到边遍历边修改列表引发的逻辑紊乱。这些并非偶然失误，而是语言特性与惯性思维碰撞的结果；掌握背后的原理并遵循实用避坑技巧（如统一空格缩进、用None替代可变默认值、避免遍历时修改原列表等），能帮你快速跨越新手期，写出更健壮、更符合Python风格的代码。

Python看似简单，但新手常因忽略语言特性或惯性思维栽跟头。下面这些错误高频出现，搞懂它们能少走很多弯路。

缩进错误：不是风格问题，是语法硬性要求

Python用缩进来定义代码块，而非大括号。混用空格和Tab、缩进不一致、该缩进没缩进或不该缩进却缩进了，都会直接报 IndentationError。

• 统一用4个空格（别用Tab），编辑器设为“显示空白字符”可直观排查
• 复制粘贴外部代码时特别小心——网页或文档里的缩进常被转成Tab或不规则空格
• if、for、def、class 等后必须接冒号，下一行必须缩进

变量未定义就使用：名字错了或作用域搞混了

报错 NameError: name 'xxx' is not defined 是新手最常遇到的之一。

• 拼写错误：比如把 user_name 写成 username 或 user_nam
• 作用域误用：函数内定义的变量，在函数外直接调用会报错；循环变量（如 for i in range(3) 中的 i）在Python 3中不会泄露到外层，但新手常误以为它一直存在
• 赋值前引用：比如写 count = count + 1 却忘了先定义 count = 0

可变对象当默认参数：隐藏的“记忆陷阱”

写类似 def add_item(item, lst=[]): lst.append(item); return lst 的函数，第二次调用会发现列表“记得”上次的内容——这不是bug，是设计使然。

• 默认参数在函数定义时只计算一次，可变对象（如列表、字典）会被反复复用
• 正确写法：用 None 作默认值，内部判断并初始化：def add_item(item, lst=None): if lst is None: lst = []
• 这个坑连不少有经验的人也会踩，务必养成“默认参数不用可变对象”的习惯

字符串与数字混用：类型不匹配不报错？其实会

比如 "age: " + 25 会报 TypeError: can only concatenate str (not "int") to str；而 "3" + "5" 得到的是 "35" 不是 8。

• Python不做隐式类型转换，拼接字符串必须全是 str，计算数字必须全是数值类型
• 用 str(25) 转字符串，用 int("3") 或 float("3.14") 转数字
• f-string（如 f"age: {age}"）会自动转换，但前提是变量本身能被合理表示为字符串

修改列表同时遍历它：边走路边拆桥

写 for item in my_list: if condition: my_list.remove(item)，容易漏删、跳项甚至报错。

• 遍历时修改原列表，索引会错乱，后续元素可能被跳过
• 安全做法：用列表推导式重建 my_list = [x for x in my_list if not condition]，或反向遍历 for i in range(len(my_list)-1, -1, -1)
• 若需就地修改且逻辑复杂，先收集要删的索引或元素，再统一处理

好了，本文到此结束，带大家了解了《Python新手常见错误及避坑技巧》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！