python新手常见五大陷阱：缩进必须统一用4空格；变量名拼写、作用域或分支定义不全致nameerror；可变对象不可作默认参数，应改用none初始化；字符串拼接需类型一致，f-string调用方法勿漏括号。
Python新手常因忽略语言特性或惯性思维掉进“看似合理实则报错”的坑里。这些错误不难解决，但容易反复出现、耽误学习节奏。
缩进不当：不是风格问题，是语法硬性要求
Python用缩进来定义代码块，而非大括号。混用空格和Tab、缩进多一层或少一层，都会直接触发IndentationError 或TabError 。
编辑器务必设为“显示空白字符”，确认统一用4个空格（PEP 8推荐）
复制他人代码时，粘贴后全选→重新缩进（多数编辑器支持Ctrl+Shift+I或Cmd+Shift+I）
不要手动敲Tab键 ——IDE通常会自动转成空格；若手动敲了，检查设置里是否启用了“Tab转空格”
变量未定义就使用：名字错了、拼写漏了、作用域搞混了
NameError: name 'xxx' is not defined 是新手最高频报错。常见原因有三种：
Sora
Sora是OpenAI发布的一种文生视频AI大模型，可以根据文本指令创建现实和富有想象力的场景。
下载
变量名打错：比如定义了user_name，却写了username（少下划线）
在函数内修改全局变量但没声明：count = 0在函数外，函数里写count += 1会报错，需加global count
条件分支中只在某一分支定义变量：if里赋值了result，else没赋，后续直接用就会报错
可变对象当默认参数：函数多次调用结果“串了”
写def add_item(item, lst=[]): lst.append(item); return lst看似正常，但第二次调用会发现列表里有前一次的元素——因为[]在函数定义时只创建一次，后续每次调用都复用同一个列表对象。
立即学习 “Python免费学习笔记（深入）”；
正确写法：用None作默认值，函数内再初始化：def add_item(item, lst=None): if lst is None: lst = []
这个坑对字典、集合等可变类型同理，切记：所有可变对象都不该当默认参数
字符串拼接与格式化误用：+ 和 f-string 混搭出错
想打印"年龄：" + age，但age是整数，会报TypeError: can only concatenate str... ；又或者用f-string时写成f"姓名：{name.upper}"（漏了括号），结果输出的是方法对象地址而非大写字符串。
拼接前统一转成字符串："年龄：" + str(age)
f-string里调用方法必须带括号：f"姓名：{name.upper()}"
不确定类型时，优先用f-string或.format()，它们会自动做类型转换
AdGuard启用HTTPS过滤后提示证书错误，源于其自签名根证书未被系统信任，需手动安装并设为受信任，同时清除SSL缓存、排查安全软件冲突。 AdGuard浏览器插件启用后突然提示“证书错误”或“您的连接不是私密连接”，通常不是网站本身问题，而是AdGuard在启用HTTPS过滤时自动生成并安装了本地根证书，而该证书未被系统或浏览器完全信任，导致所有HTTPS页面被拦截并报错。 检查AdGuar...
2026-05-31 · 软件教程 · 231667
iPhone照片上传提示格式错误，主因是HEIC格式不兼容；可通过五种方法解决：一、改相机设置为兼容性最佳；二、用“文件”App转JPEG；三、Windows装HEIF扩展；四、微信中转自动转码；五、快捷指令批量转换。 如果您在上传苹果手机拍摄的照片时，系统提示“格式错误”或“不支持该图片格式”，很可能是照片被自动保存为HEIC编码格式，而目标平台仅识别JPG或JPEG扩展名；也可能是相册应用在保...
2026-05-21 · 手机教程 · 107414
pytest.mark 必须作为装饰器直接作用于测试函数或类，不可写在函数外部；可叠加多个标记，执行时用 -m "mark1 and mark2" 等布尔表达式筛选；未注册标记会触发警告，需在 pytest.ini 或 pyproject.toml 中声明以避免。 pytest.mark 能不能直接用在函数外面 不能。所有 pytest.mark 必须装饰在测试函数或类上，写在函数定义之外会报 S...
yield from 在树遍历中省去了手动展开子生成器的繁琐与风险，自动处理委托调用、异常传播、StopIteration 捕获及协程方法转发，确保扁平化输出和行为一致性。 yield from 在树遍历中到底省了什么 直接说结论：yield from 不是语法糖，它把递归生成器的“委托调用”从手动循环 + yield 拆解成一条语句，避免了中间迭代器被提前耗尽、异常传播断裂、或 StopIter...
Python函数内同名变量报UnboundLocalError，因编译期将赋值变量标记为局部，读取在赋值前则出错；global用于模块级变量，nonlocal用于最近外层函数变量，二者不可混用且需提前声明。 为什么在函数里修改同名变量会报 UnboundLocalError Python 在编译函数时，只要看到某个变量在函数体内有赋值操作（哪怕只在 if 分支里），就会把它标记为局部变量。之后如果...
Python内存泄漏主因是对象被隐性持有而非未调gc.collect()，可用objgraph.show_growth()定位异常增长类型，再用gc.get_referrers()逆向追踪强引用源，并结合RSS监控与gc调试确认真实泄漏。 Python 脚本内存持续上涨，大概率不是“没调 gc.collect()”，而是对象根本没被识别为可回收——比如被全局容器悄悄持有、含 __del__ 的循环...
app.cli.command命令不出现的主因是Flask实例未完成初始化或注册时机过早；需确保在create_app()返回后注册，且装饰器顺序为@app.cli.command在上、@click.option等在下，同时避免顶层导入时执行注册。 为什么 app.cli.command 注册的命令不出现？ 最常见原因是 Flask 应用实例未正确初始化 CLI 上下文，或者命令注册时机早于 ap...
Canvas无法直接保存为图片，需用ImageGrab截屏并精确计算坐标，Windows高DPI下须启用DPI感知并缩放坐标；更可靠方案是用PIL重绘所有元素。 Canvas 本身不支持直接保存为图片文件，所谓“保存空白”不是 bug，而是你根本没在保存 Canvas 的内容 Canvas 没有内置 save() 或 export() 方法 Tkinter 的 Canvas 是一个绘图容器，它只负...
