一文搞懂如何在Cursor新版本(0.45+)中使用规则
一文搞懂如何在Cursor新版本(0.45+)中使用规则
Cursor规则是Cursor代码编辑器中非常重要的功能,它可以帮助开发者更好地管理和规范代码库。本文将详细介绍Cursor规则的作用、使用建议以及在不同版本中的规则定义方式,帮助开发者充分利用这一功能。
Cursor规则的作用
Cursor规则可以说是最重要的,这个规则直接影响我们编写代码的质量。Cursor 规则是用户提供的一组指导说明,用来帮助 AI 更好地理解和处理代码库,这些规则可以包含特定的代码处理要求、项目规范或者其他重要信息,所以说其非常非常重要。
主要用途:
- 提供项目上下文
- 设置编码风格指南
- 说明常用方法和框架的使用规范
- 自定义 AI 响应的行为方式
使用建议:
- 推荐使用Markdown格式来编写Cursor规则文件,避免使用JSON格式,因为测试显示效果较差。
- 定期更新规则以适应项目发展
- 可以让AI自己扫描代码库来生成或更新规则
- 建议包含项目特定的框架、库和编码约定
理解Cursor规则
Cursor中的规则文件就是你的AI编码助手的一份指南,它告诉AI如何为你的项目编写代码,包括你使用的工具以及他们之间如何进行组织的,这有助于Cursor创建更好、更准确的代码。
如何在Cursor中定义规则
在v0.45版本之前,Cursor使用一个名为.cursorrule
的文件来定义全局规则。但是从v0.45版本开始,之前的.cursorrule
文件被官方弃用,取而代之的是在.cursor/rules
目录中使用.mdc
扩展名的特殊文件(MarkdownCursor的缩写)。这种方式更加灵活,可以为不同类型文件(如.ts
、.tsx
、.md
等)或整个子文件夹设置特定的规则。
要添加规则文件很简单,我们可以手动创建.cursor/rules
目录,然后手动在该目录下面创建xx.mdc
文件即可。打开这个文件后会出现如下图所示的视图:
其中有3个主要部分:
- Description:描述规则的,Agent会基于该描述来选择该规则
- Globs:指定文件模式(比如
.tsx
)时,该规则将自动应用于与该模型匹配的文件的AI响应中 - Content:核心内容区域,编写具体的规则,可以用Markdown语法格式,此外我们也可以使用
@
来指定文件
现在我们就可以将规则分离成很多更小的规则文件了。
引导Agent
使用.cursor/rules
目录这种方式我们还可以构建一个完全自主控制的Agent,当然首先我们需要在Cursor中启用Agent模式,然后只需要在规则文件中描述清楚应该处理哪个脚本或文档即可。在Agent模式下面,我们是在告诉Agent如何来操作,而不仅仅只是把规则列出来。
当然即使我们不使用这种方式,Cursor Agent也可以自动选择匹配的规则来应用。如下图所示:
我们添加了一个本地搜索的规则文件,然后在Agent模式下面,我们只需要提到Local Search,Agent就会自动为我们应用对应的这个规则来执行操作,足见Agent语意理解能力是非常强大的,这样我们就可以做很多扩展操作了。