[Cursor] @命令

@ 命令是一个很有用的工具，核心就是为 AI 聊天添加更加具体的上下文信息。

你在 Chat 窗口输入 @ 时，就可以看到很多选项。

你可以这样使用 @ 命令：

1. 在输入框中输入 @
2. 用上下键选择你想要的命令
3. 按 Enter 键确认

1. Files&Folders

引用项目中的特定文件和文件夹作为上下文。

2. Code

引用代码片段。

3. Docs

获取官方文档或者第三方文档信息。

4. Git

使用 @Git 相关的特殊指令来分析当前项目的 Git 变更情况、比较分支内容、以及查看未提交的文件状态。

@Commit：引用当前工作状态的改动

使用 @Commit，你可以让 AI 告诉你当前工作区与最近一次提交（HEAD）之间的“未提交变更”。变更包括新增的文件、修改的文件以及删除的文件

[!note]

例如：你在当前项目中修改了 login.js 和 auth.js，尚未提交，现在想知道这两处的改动有没有问题。你可以对 AI 说：请帮我检查一下 @Commit 中的改动有没有潜在的问题，比如逻辑错误或代码风格不统一。

AI 会读取尚未提交的变更，并反馈比如：

• “auth.js 中的错误处理逻辑存在重复”
• “login.js 的登录判断条件可能导致空密码通过验证”

@Branch：对比当前分支与主分支的差异

使用 @Branch，可以查看当前分支与主分支（如 main）之间的差异：

• 显示当前分支新增的提交
• 展示和主分支不同的代码的变更内容

[!note]

例如：你在一个 feature/signup-flow 分支上开发了注册流程，准备合并回 main，但不确定有哪些重要更改。你可以对 AI 说：请帮我总结一下 @Branch 中相对于 main 分支的所有功能改动，方便我写 PR 描述。

AI 会列出当前分支比 main 多出的提交与变更，比如：

• “新增了 SignupForm.vue 组件”
• “修改了 API 调用逻辑”
• “引入了新的依赖（如 yup 用于表单验证）”

5. Terminals

用于在 Chat 中引用你当前终端中的输出结果或状态信息，让 AI 可以根据终端反馈内容给出解释、建议或下一步操作。

与传统 Chat 模式的区别

模式	是否能读取终端输出	是否能帮你生成命令
普通聊天	❌ 只能靠你复制粘贴内容	✅ 能生成，但不知上下文
@Terminal	✅ 可自动引用终端上下文	✅ 更准确、带环境感知能力

6. Linter Errors

@Lint Errors 是 Cursor 中用于访问并引用代码中的 Lint 报错与警告信息的快捷符号。这个符号可以自动捕获并提供你当前激活文件中所有的 lint 报错与警告。

7. Web

@Web 命令会自动搜索互联网以查找与 Cursor 查询相关的上下文。

---

-EOF-