Trae CN Python环境调试debug

Trae安装好后不能像vscode那样debug只能用print调试很麻烦这里记录配置方法。一、为什么需要 Debug在日常开发中遇到程序异常时我们的第一反应往往是print()大法——哪里不对打哪里。但随着业务逻辑变复杂print的效率会急剧下降你需要反复加打印、跑脚本、看日志、删打印循环往复。Debug断点调试能让你在代码运行时随时冻结程序查看那一刻所有变量的真实值单步跟踪执行路径。一次配置终身受益。二、环境准备使用uv管理依赖的 Python 项目为例obj_fy/├── .venv/ # 虚拟环境├── .vscode/│ └── launch.json # 调试配置待创建├── pyproject.toml # 项目依赖└── demo_20260811.py # 待调试脚本三、第一步安装 Python Debugger 扩展在 Trae 左侧栏点击扩展图标或按快捷键CtrlShiftX搜索框输入debugpy找到Python Debugger发布者为 Microsoft点击安装安装完成后点击启用如未自动启用注意安装后建议重启 Trae确保扩展完全加载。四、第二步配置 launch.json扩展安装后还需要一个配置文件告诉 IDE “怎么启动调试”。4.1 创建配置文件在项目根目录的.vscode文件夹中打开或新建launch.json写入以下配置{version:0.2.0,configurations:[{name:Python: 当前文件,type:debugpy,request:launch,program:${file},console:integratedTerminal,cwd:${workspaceFolder},python:${workspaceFolder}/.venv/Scripts/python.exe}]}4.2 字段含义详解字段值说明namePython: 当前文件调试配置名称下拉选择时显示typedebugpy指定使用 debugpy 调试器requestlaunch启动模式每次调试新启一个进程program${file}当前在编辑器打开的文件consoleintegratedTerminal在集成终端中运行方便输入和查看输出cwd${workspaceFolder}运行目录设为项目根目录python.venv路径指向项目的虚拟环境 Python隔绝全局干扰五、设断点定位 Bug5.1 设置断点在代码编辑器中行号左侧空白处单击出现一个红色圆点即断点已设置。deffun1():满聚统计-英文学位论文print(开始处理数据)# ← 在这行设断点dataload_jsonl(input/)resultaggregate(data)# ← 也可以在这行设断点returnresult5.2 启动调试确保你已打开待调试的.py文件如manju_20260811.py点击左侧栏运行和调试图标或按CtrlShiftD顶部下拉选择“Python: 当前文件”点击绿色三角按钮或直接按F5程序运行到断点处会自动暂停当前行高亮显示为黄色。5.3 调试工具栏操作指南程序暂停后顶部出现调试工具栏按钮快捷键功能使用场景继续F5运行到下一个断点确认当前段没问题跳到下一检查点逐过程F10执行当前行不进入函数内部确认函数调用结果不关心内部细节逐语句F11进入函数内部逐行执行怀疑函数内部有 Bug需要深入排查跳出ShiftF11跳出当前函数函数内排查完毕回到调用处重启CtrlShiftF5重新启动调试修改代码后重新跑一遍停止ShiftF5终止调试确认问题已定位结束调试5.4 查看变量与表达式程序暂停时左侧面板会显示变量Variables当前作用域内所有变量及其值展开可看嵌套结构监视Watch手动添加表达式如len(data)、data[0][title]实时计算结果调用堆栈Call Stack显示函数调用链路点击可跳转到调用方六、常见问题Q1右键菜单没有调试 Python 文件选项原因未安装 debugpy 扩展或未配置 launch.json。解决按本文第三章、第四章顺序操作完成后重启 Trae。Q2启动调试报debugpy not found原因虚拟环境中没有 debugpy 包。解决执行uv pip install debugpy确认.venv/Scripts/python.exe路径正确。Q3断点是灰色空心圆不会命中原因launch.json 中的python路径与实际解释器不一致。解决在终端执行.venv\Scripts\python.exe -c import sys; print(sys.executable)获取正确路径或临时删除launch.json中的python字段让系统自动选择解释器Q4程序直接跑完不暂停原因断点所在代码分支未被执行到如if条件不满足。解决在函数入口处如def fun1():下一行先设一个断点确保程序能停下来再逐步跟进。