用trae ai调试项目需先在本地终端启动服务并连接git仓库,再通过web界面设置断点、查看变量和单步调试;全过程依赖正确配置的项目结构和python环境。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用Trae AI调试项目,需要先在本地终端启动Trae服务并连接到你的代码仓库,再通过Web界面设置断点、查看变量和执行单步调试。整个过程依赖正确配置的项目结构和Python环境,缺一不可。
安装并启动Trae CLI
在项目根目录下运行 pip install trae 安装命令行工具。这一步必须在项目所用的Python环境中执行,否则后续无法识别项目依赖。
安装完成后,执行 trae init 初始化配置文件 .trae/config.yaml。该命令会自动检测当前目录是否为Git仓库,【不是Git仓库时会直接报错退出,无法继续】。
接着运行 trae start 启动本地服务。终端输出类似 Listening on http://localhost:3000 表示成功,此时不要关闭该终端窗口。
在Web界面中加载项目并设置断点
打开浏览器访问 http://localhost:3000,页面自动加载当前仓库的文件树。点击任意Python文件(如 main.py)进入编辑视图。
方法一:鼠标悬停在行号左侧灰色区域,出现蓝色圆点后单击,即可在该行设置断点。断点只对运行时生效,保存文件不会自动持久化断点。
方法二:按住 Ctrl(Windows/Linux)或 Cmd(macOS),再点击行号,可批量添加多个断点。一次最多选中15行,超出部分会被忽略。
触发调试会话并观察执行状态
第一步:在Web界面右上角点击 【Run & Debug】 按钮,Trae会自动读取 .trae/config.yaml 中的 entry_point 字段作为启动脚本。
第二步:若配置中未指定 entry_point,系统将弹出输入框,要求手动填写相对路径(例如 src/app.py)。填错路径会导致进程立即退出,且无详细错误提示。
第三步:调试启动后,左侧变量面板实时显示当前作用域内的所有变量值。点击变量名可展开嵌套结构,但无法修改其值——Trae不支持运行时变量赋值。
第四步:使用顶部控制栏的 ▶️(继续)、⏸(暂停)、⏭(单步跳过)、⤵(单步进入)按钮操作执行流。其中 ⤵ 会进入函数内部,若目标函数来自第三方包且未安装源码,则跳转失败并停留在当前行。











