cursor 使用教程(10)—— @ 提示符

2,426 阅读3分钟

完整教程请点击专栏查看。

@ 提示符在内嵌对话框、CHAT、COMPOSER 中都有,同一个提示符的含义是相同的,接下来我一一讲解各个提示符的含义。

image.png

Files

把文件的内容加到上下文,也可以通过拖拽文件的方式添加。可以让 cursor 为我们讲解文件内容,也可以让他分析文件在 Codebase 中的作用。

image.png

Folders

把文件中所有文件加到上下文,也可以通过拖拽文件夹的方式添加。

我看有的教程说 Folders 容易出现幻读,即返回了文件夹中没有的文件,我倒没遇到这个问题,我遇到的是无法通过 @ 提示符联想到 Folders,必须手动拖拽到对话框,如下图所示。

我在 new 文件夹中复制了几个文件和文件夹进去,cursor 都能正确识别。

image.png

Code

这是 cursor 根据项目自动生成的分块 Code,这个提示符不会用到,就不做演示了,建议先圈选代码再 Add to Chat,或 Ctrl+K。

Doc

可以把网上的文档录入 cursor Doc,在让 cursor 按照文档写代码。这在对接三方 API 的场景中,非常有用。

比如把 help.aliyun.com/zh/sms/gett… 这个阿里云发送 SMS 的文档链接给他,让他帮我生成调用代码。

添加 Doc

后台添加
  1. 在设置 -> Features -> Docs 中,点击 Add new doc 添加。

image.png

  1. 在点击 @Doc 提示符后,最下面有个 Add new doc。

image.png

进入 Add new doc 后,输入文档地址,cursor 会自动抓取信息,如需调整名称可以重命名,否则点击 confirm 即可。

image.png

使用 Doc

仅需一句话,即可让 cursor 生成调用代码。

image.png

各种语言,任君选择,比如我让他用 go 写个。

image.png

Git

可以选中 Git 的某一次提交,询问 cursor 代码改动、逻辑变化,他会根据 Git 的代码变动回答。

Notepad

和文件很像,这是 vscode 中左下方有个 Notepad 的板块里面的文件。

image.png

Suggested

这里是 cursor 智能判断我们可能需要的引用,一般不会用到。

Codebase

之前的篇幅中已经讲过了。在专栏里面。

Lint Errors

可以检测代码问题,不仅是语法、编译错误,还能检测规范,比如重复代码、未使用变量、命名规则等。

一般是 @Lint Errors 再接 @File 或是圈选代码块。

image.png

Web

可以读懂网页的内容,再基于网页做解释和回答。

通常不会先 @Web,而且直接把网址复制到对话框中,就会自动带上 @Web。

image.png

Definitions

这只提示符只在内嵌对话框中有,他是当前代码的上下文,在 cursor 对上下文理解不对时,可以用这个注解强制让他理解上下文。

image.png

当我刚写完以上内容,2025-01-28 收到了 cursor 更新,新增了两个提示符,Summarized Composers 和 Cursor Rules。

Summarized Composers

可以提取之前 Composers 对话的内容,并作为引用加入上下文,比如按照上次 Composers 的做法,同样更改这次代码,或总结指定 Composers 的内容。

image.png

Curosr Rules

之前讲解过 cursor 中 Rules for AI,这次更新对 Rules 做了加强,扩充了单文件 .cursorrules,可以针对项目更多分类的 Rules,支持互相引用,像组合编程,还支持匹配特定的目录、文件。

这部分内容,我会补充在 Rules for AI 中,现在只看这个提示符的作用。

首先在后台创建一个 rules1。

image.png

然后我可以让他按照 rules1 改写文件。

image.png

它成功的读懂了,并只把文件夹改为小写,这正是 rules1 中的规范。

Recent Changes

这就是字面意思,可以分析代码最近的改动,可以从 Git 和本地文件中获得信息。