人人都会AI编程

3.4.3 @终端:引用运行报错与输出结果

更新时间:2026-06-30

调试程序时,终端输出的报错堆栈和日志是定位问题的第一手材料。@终端 允许你在侧边栏对话中直接引用当前活跃终端的最新输出,无需手动复制粘贴,即可让 AI 基于真实运行结果进行诊断分析。

如何引用

在侧边栏对话输入框中输入 @,选择 终端,系统会自动捕获当前终端窗口的可见输出内容。随后直接提问即可,例如:

"帮我分析一下这个报错的原因 @终端"
"测试失败,看看需要改哪里 @终端"

CodeBuddy 支持引用 VS Code 集成终端的输出,也支持桌面客户端内置终端或外接终端窗口的内容(视具体版本而定)。

典型适用场景

  • 运行时异常:程序抛出空指针、越界或类型错误后,直接引用堆栈信息,让 AI 结合代码行号定位根因。
  • 编译与构建失败:Webpack/Vite/Maven 等构建工具输出大量日志时,由 AI 从中提取关键错误,避免人工逐行翻阅。
  • 单元测试未通过:将测试框架的输出结果直接抛给 AI,辅助对比预期值与实际值,修正断言或业务逻辑。
  • 命令执行异常:数据库迁移、依赖安装(npm/pip)、Docker 构建等命令失败时,结合终端输出排查环境或权限问题。

实用技巧

| 技巧 | 说明 |
|:---|:---|
| 自动聚焦尾部信息 | 终端输出较长时,AI 会优先从末尾向上扫描,自动聚焦最新的报错堆栈,无需手动裁剪。 |
| 多轮调试闭环 | 按建议修改代码后重新运行,再次 @终端 可快速验证问题是否解决,形成“运行→诊断→修复”的连贯循环。 |
| 注意敏感信息 | 引用前确认终端中没有明文输出密码、API Key 或 Token。如不放心,可先清除敏感行或关闭相关日志再使用。 |
| 配合代码定位 | 在 @终端 的同时,用 @文件 引用报错相关的源码文件,AI 能更准确地建立堆栈行号与代码的对应关系,提升修复准确率。 |

与手动复制的区别

直接引用保留了终端输出的原始顺序与格式,避免手动复制时遗漏关键环境信息(如执行路径、Node.js 版本、操作系统提示)。对于包含 ANSI 颜色代码的日志,AI 也能正常识别其中的错误级别和模块划分,减少信息失真。