在开发过程中,终端里的报错堆栈、编译日志或测试回显往往是最直接的问题线索。手动复制粘贴这些内容到 AI 对话框既繁琐,也容易漏掉关键上下文。使用 @终端(输入 @terminal 亦可)指令,Cursor 会自动抓取项目终端面板中的最近输出,作为上下文提交给 AI 分析。
典型使用场景
- 编译构建失败:
npm run build或cargo build报错后,直接让 AI 读终端输出并定位错误代码; - 测试日志解读:单元测试批量失败时,让 AI 总结失败原因并给出修复方案;
- 命令结果处理:将
curl返回的 JSON、数据库查询结果或脚本输出丢给 AI,请求解析、格式化或生成处理代码; - Git 操作辅助:引用
git status、git diff或合并冲突的终端输出,让 AI 解释差异并建议下一步操作。
操作方式
- 先通过 `
Ctrl +`` 或菜单打开底部终端面板,执行相关命令; - 在侧边栏 AI 对话框或行内编辑框中输入
@,选择 Terminal(终端),Cursor 会自动将终端最近若干行输出作为引用块插入对话; - 补充你的具体问题,例如:"这个报错怎么修复?" 或 "把这些 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 分析。 - 隐私敏感信息:终端输出中可能包含环境变量、密钥或服务器路径。引用前确认终端内容不含敏感信息,必要时手动脱敏后再提问。