直接用cursor内置调试器图形化单步追踪python项目问题:先配置python.defaultinterpreterpath为项目python绝对路径,确保右下角显示绿色对勾;再设断点、启动调试(ctrl+shift+d/cmd+shift+d),通过f10/f11/shift+f11单步执行,变量面板实时查看并可双击修改值。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想在Cursor中快速定位Python项目里的变量值异常、函数执行卡点或逻辑跳转错误,不用反复加print,也不用切到命令行手动启动pdb——直接用内置调试器就能图形化单步追踪。
配置Python解释器路径
打开项目根目录下的.cursor/settings.json文件(若不存在则新建),在"python.defaultInterpreterPath"字段填入你项目实际使用的Python可执行文件绝对路径,比如/opt/anaconda3/envs/myproject/bin/python。这一步漏掉会导致后续所有断点都不生效,因为Cursor根本找不到能运行代码的Python环境。
确认路径正确后保存文件,右下角状态栏会显示“Python 3.x.x”且旁边带绿色对勾图标,表示解释器已就绪。
设置断点并启动调试会话
在你想暂停执行的代码行左侧灰色区域单击,出现红点即为断点;支持同时设多个断点,包括函数入口、循环体内、异常捕获块前。
按Ctrl+Shift+D(Windows/Linux)或Cmd+Shift+D(macOS)打开调试面板→点击左上角绿色三角形“运行和调试”按钮→选择“Python File”配置项→点击“开始调试”。
此时程序会在第一个断点处暂停,变量面板自动展开,调用栈、断点列表、调试控制条同步激活。
单步执行与变量观察
方法一:使用顶部调试工具栏按钮
点击【跳过】(F10)执行当前行但不进入函数内部;点击【步入】(F11)进入当前行调用的函数;点击【跳出】(Shift+F11)执行完当前函数并返回上一层。
方法二:键盘快捷键驱动
① 按F10逐行运行,适合快速跳过已确认无误的赋值或打印语句;
② 遇到疑似问题函数时立刻按F11钻进去,查看参数传入是否符合预期;
③ 在函数末尾按Shift+F11,避免陷入底层库源码;
④ 按F9可临时禁用/启用某断点,避免重复触发干扰观察。
变量值实时显示在“变量”面板,点击右侧小箭头可展开嵌套对象;鼠标悬停在代码中的变量名上,会浮出当前值快照——但注意,悬停只显示简单类型,复杂对象(如DataFrame、自定义类实例)必须在变量面板里点开才能看全属性。
修改变量值并继续执行
在“变量”面板中找到目标变量,双击其右侧数值列,输入新值(支持数字、字符串、布尔值、None),回车确认。
这一步会直接修改运行时内存中的值,影响后续逻辑走向;【不可撤销】,改错后只能重启调试会话。
修改完成后点击调试工具栏的“继续”(F5),程序从当前暂停位置继续运行,直到下一个断点或自然结束。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











