Python 初学者最容易卡住的 5 个地方,我都踩过

作为一个从 “零基础” 摸爬滚打过来的 Python 学习者，我至今记得刚开始写代码时的崩溃瞬间：明明照着教程敲的代码，运行就报错；看似简单的逻辑，调试半天找不到问题；好不容易跑通了，换个场景又卡壳。后来回头看，发现很多坑其实是初学者的 “共性难题”—— 不是我们不够聪明，而是没摸透 Python 的 “脾气”。今天就把我踩过的 5 个最要命的坑拎出来，说说当时怎么卡住的，又怎么一步步爬出来的，希望能帮新手少走点弯路。

一、缩进错误：“明明对齐了，怎么还报错？”

这是我入门时栽的第一个大跟头，也是最容易让人怀疑人生的错误。Python 的缩进不是 “建议”，而是 “语法规则”—— 用空格或 Tab 键控制代码块归属，不像其他语言用大括号{}，一旦缩进乱了，程序直接罢工。

我的踩坑经历：

刚学if-else语句时，照着教程写了一段判断成绩的代码：

    score = 85if score >= 60:print("及格啦")  # 这里直接报错！else:print("还要加油")

我盯着屏幕看了十分钟，觉得print("及格啦")和下面的print对齐了呀，怎么会报IndentationError: expected an indented block？后来才发现，教程里用的是 4 个空格缩进，我随手按了 Tab 键（不同编辑器 Tab 对应的空格数不一样），看似对齐，实际缩进长度不统一，Python 认不出来这是if下面的代码块。

还有一次更离谱：写循环嵌套时，内层循环多敲了一个空格，结果程序逻辑全乱 —— 本想遍历列表里的每个元素，却变成了重复打印第一个值，调试了半小时才发现是缩进多了一格。

解决方法：

1. 统一缩进标准：全程用 4 个空格（推荐）或 1 个 Tab 键，千万别混着用！可以在编辑器里设置 “Tab 键自动转为 4 个空格”（VS Code、PyCharm 都有这个功能），从根源上避免问题；
2. 借助编辑器提示：新手可以打开编辑器的 “显示空格” 功能（比如 VS Code 按Ctrl+Shift+P搜索 “Toggle Render Whitespace”），能清楚看到每一行的缩进是否一致；
3. 记住 “冒号后必缩进”：只要代码行末尾有冒号:（比如if、for、def、class后面），下一行必须缩进，直到代码块结束再恢复原缩进级别。

二、变量与数据类型：“为什么我的变量‘不听话’？”

Python 是 “动态类型语言”，不用提前声明变量类型，看似方便，实则藏着很多坑 —— 新手很容易混淆变量赋值、类型转换，或者在字符串、列表操作上栽跟头。

我的踩坑经历：

第一次写 “计算购物总价” 的代码时，卡了半天：

    price = input("请输入商品价格：")    count = input("请输入购买数量：")    total = price * countprint("总价是：", total)

我输入50和3，本以为会输出150，结果直接报错TypeError: can't multiply sequence by non-int of type 'str'。后来才知道，input()函数获取的是字符串类型，哪怕你输入的是数字，Python 也当成文本处理，字符串和字符串相乘是重复拼接（比如"50"*3会得到"505050"），而不是数学计算。

还有一次，想给列表添加元素，用了list = list + "abc"，结果报错 —— 原来列表只能和列表拼接，不能直接加字符串，正确的写法是list.append("abc")或list += ["abc"]。

解决方法（亲测好用）：

1. 明确变量类型：不确定变量类型时，用type(变量名)查看（比如type(price)会显示str'>），遇到需要计算的场景，及时用int()（转整数）、float()（转小数）转换；
2. 牢记常见数据类型的操作规则：

• 字符串：用+拼接、*重复，不能直接修改单个字符（比如str[0] = "a"会报错）；
• 列表：用append()添加元素、extend()合并列表、pop()删除元素，支持list[0]修改值；
• 字典：用dict[key]取值或赋值，键必须是不可变类型（比如字符串、数字，不能是列表）；

1. 避免 “变量名冲突”：别用 Python 内置关键字（比如print、list、str）当变量名，否则会覆盖原有功能（比如print = 10后，再用print("hello")就会报错）。

三、循环与条件判断：“逻辑明明对，怎么执行结果不对？”

循环（for/while）和条件判断（if-elif-else）是 Python 的基础逻辑，但新手很容易在 “循环边界”“条件表达式” 上出错，尤其是嵌套循环和range()函数的使用。

我的踩坑经历：

学for循环时，想打印 1 到 10 的数字，写了这样的代码：

for i in range(10):   print(i)

结果输出从0开始到9结束，少了10—— 原来range(n)是 “左闭右开”，包含开头不包含结尾，想要 1 到 10，得写range(1, 11)。

还有一次写 “判断一个数是否是质数” 的代码，逻辑绕来绕去：

num = 7is_prime = Truefor i in range(2, num):   if num % i == 0:       is_prime = False   else:       is_prime = Trueprint(is_prime)

我以为会输出True（7 是质数），结果真的输出True，但后来测试num=9时，居然也输出True—— 原来循环里只要遇到一个不能整除的数，就把is_prime设为True，覆盖了之前的判断。正确的逻辑应该是：一旦找到能整除的数，直接设为False并跳出循环，否则保持True。

解决方法（亲测好用）：

1. 搞懂range()的用法：

• range(n)：生成 0 到 n-1 的整数（比如range(3)→0,1,2）；
• range(a, b)：生成 a 到 b-1 的整数（比如range(2,5)→2,3,4）；
• range(a, b, step)：生成 a 到 b-1、步长为 step 的整数（比如range(1,10,2)→1,3,5,7,9）；

1. 条件判断 “先明确边界”：写if语句前，先想清楚 “满足什么条件执行 A，否则执行 B”，避免多条件时逻辑重叠（比如if x>10和if x>=10不能同时放在前面）；
2. 循环里用break和continue简化逻辑：遇到 “找到目标就停止” 的场景用break（比如质数判断中找到能整除的数就跳出循环），遇到 “跳过当前次循环” 的场景用continue（比如打印 1 到 10，跳过偶数）；
3. 复杂逻辑 “分步调试”：新手可以在循环里加print语句，查看每次循环中变量的变化（比如print(i, num%i)），就能快速找到逻辑漏洞。

四、函数定义与调用：“参数怎么传都不对？”

函数是 Python 的核心，但新手很容易在 “参数传递”“返回值” 上卡住 —— 比如不知道参数顺序、分不清位置参数和关键字参数、忘记写return语句导致函数没结果。

我的踩坑经历：

第一次写 “计算矩形面积” 的函数，卡了好久：

def calculate_area(length, width):   area = length * width   # 忘记写return语句！result = calculate_area(5, 3)print("面积是：", result)

运行后输出面积是： None，我以为函数里计算了area就会自动返回，结果不知道 Python 函数如果没有return语句，默认返回None。

还有一次调用函数时，参数顺序搞反了：

def print_info(name, age):   print(f"姓名：{name}，年龄：{age}")print_info(25, "小明")  # 顺序错了！

输出姓名：25，年龄：小明，明显不符合预期 —— 原来函数参数默认是 “位置参数”，传递时必须和定义的顺序一致，除非用 “关键字参数” 指定（比如print_info(age=25, name="小明")）。

解决方法（亲测好用）：

1. 函数必须有return才会返回结果：如果函数需要输出某个值，一定要写return 结果（比如return area），否则调用后得到的是None；
2. 参数传递 “要么按顺序，要么指定关键字”：

• 位置参数：按函数定义的顺序传递（比如calculate_area(5,3)，5 对应 length，3 对应 width）；
• 关键字参数：用参数名=值的形式传递（比如calculate_area(width=3, length=5)），顺序可以打乱；

1. 给参数设默认值（可选）：如果函数的某些参数经常用固定值，可以在定义时设默认值（比如def calculate_area(length, width=2)），调用时可以只传 length（比如calculate_area(5)，width 默认是 2）；
2. 函数名和参数名 “见名知意”：别用a、b这种模糊的名字，比如length（长）、width（宽）、name（姓名），这样写和调用时都不容易出错。

五、异常处理：“程序一报错就崩溃？”

新手写的代码往往 “不堪一击”—— 比如用户输入非数字、文件不存在、网络超时，只要遇到一点意外情况，程序就直接崩溃并抛出一堆错误信息，不知道怎么优雅地处理这些异常。

我的踩坑经历：

写 “读取文件内容” 的代码时，遇到文件不存在就卡住了：

file_path = "test.txt"with open(file_path, "r", encoding="utf-8") as f:   content = f.read()print(content)

如果test.txt不存在，程序会直接报错FileNotFoundError: [Errno 2] No such file or directory: 'test.txt'，然后停止运行。我当时不知道怎么处理这种情况，只能手动创建文件，后来才知道可以用try-except捕获异常。

还有一次写 “计算除法” 的代码，用户输入0作为除数，程序直接崩溃：

a = int(input("请输入被除数："))b = int(input("请输入除数："))result = a / bprint("结果是：", result)

输入5和0后，报错ZeroDivisionError: division by zero，不知道怎么提示用户 “除数不能为 0”，而不是让程序崩溃。

解决方法（亲测好用）：

1. 用try-except捕获常见异常：把可能出错的代码放在try块里，出错后执行except块的逻辑，比如：

try:       a = int(input("请输入被除数："))       b = int(input("请输入除数："))       result = a / bprint("结果是：", result)except ValueError:print("错误：请输入数字！")except ZeroDivisionError:print("错误：除数不能为0！")except Exception as e:print(f"发生未知错误：{e}")

1. 明确捕获 “特定异常”，别用 “万能异常” 覆盖所有：比如上面的代码，分别捕获 “输入非数字”（ValueError）和 “除数为 0”（ZeroDivisionError），比直接写except:更清晰，能精准定位问题；
2. 关键操作前 “提前判断”：比如读取文件前，先判断文件是否存在（用os.path.exists(file_path)）；打开文件时指定encoding="utf-8"，避免中文编码错误；
3. 异常处理后 “让程序继续运行”：比如捕获错误后打印友好提示，而不是让程序直接退出，提升用户体验（比如上面的代码，用户输入错误后不会崩溃，还能重新运行）。

最后想说：卡住是正常的，别慌！

我刚开始学 Python 时，曾因为一个缩进错误哭丧着脸问朋友，也曾因为函数参数传不对拍桌子 —— 但现在回头看，这些坑都是 “成长必经之路”。Python 看似简单，但细节里藏着很多 “约定俗成” 的规则，新手之所以卡住，不是因为 “学不会”，而是因为 “没摸清规则”。

总结下来，新手避坑的核心就 3 点：

1. 遇到报错别害怕：仔细看错误信息（比如IndentationError是缩进错，TypeError是类型错），错误信息会告诉你 “哪里错了”“为什么错了”；
2. 多动手调试：用print语句查看变量变化，或者用编辑器的调试功能（比如 VS Code 按 F5 打断点），一步步找到问题；
3. 写代码 “先简单后复杂”：比如先写一个简单的函数跑通，再慢慢加逻辑；先处理正常情况，再考虑异常情况。

如果现在的你也卡在这些地方，别着急 —— 你遇到的问题，99% 的初学者都遇到过。慢慢踩坑，慢慢总结，过不了多久，你就会发现：曾经让你崩溃的问题，现在看都不是事儿～