人人都会AI编程

3.4.3 @终端:引用终端输出结果

更新时间:2026-06-29

在开发过程中,终端里的报错堆栈、编译日志或测试回显往往是最直接的问题线索。手动复制粘贴这些内容到 AI 对话框既繁琐,也容易漏掉关键上下文。使用 @终端(输入 @terminal 亦可)指令,Cursor 会自动抓取项目终端面板中的最近输出,作为上下文提交给 AI 分析。

典型使用场景

  • 编译构建失败npm run buildcargo build 报错后,直接让 AI 读终端输出并定位错误代码;
  • 测试日志解读:单元测试批量失败时,让 AI 总结失败原因并给出修复方案;
  • 命令结果处理:将 curl 返回的 JSON、数据库查询结果或脚本输出丢给 AI,请求解析、格式化或生成处理代码;
  • Git 操作辅助:引用 git statusgit diff 或合并冲突的终端输出,让 AI 解释差异并建议下一步操作。

操作方式

  1. 先通过 ` Ctrl + `` 或菜单打开底部终端面板,执行相关命令;
  2. 在侧边栏 AI 对话框或行内编辑框中输入 @,选择 Terminal(终端),Cursor 会自动将终端最近若干行输出作为引用块插入对话;
  3. 补充你的具体问题,例如:"这个报错怎么修复?" 或 "把这些 JSON 结果转成 TypeScript 接口",回车发送。

实际示例

假设你运行 npm run dev 后终端出现如下报错:

Error: Cannot find module '@utils/helper'
Require stack:
- /src/components/Form.tsx

此时在 AI 对话框输入:

@terminal 这个模块找不到,但文件确实存在于 src/utils/helper.ts,请帮我排查原因。

AI 会结合终端报错与项目结构,提示你可能缺少相对路径前缀、未配置路径别名,或需要检查 tsconfig.json 中的 baseUrl 设置。

注意事项

  • 先执行再引用@终端 抓取的是终端面板中已有的输出历史。若终端为空,引用内容也为空。
  • 超长日志截断:对于几千行的构建输出,Cursor 可能会自动截断最近部分。建议先用 grep 过滤关键错误行,再让 AI 分析。
  • 隐私敏感信息:终端输出中可能包含环境变量、密钥或服务器路径。引用前确认终端内容不含敏感信息,必要时手动脱敏后再提问。