3分钟学会Cursor Rules,让AI不再乱改代码!

3分钟学会Cursor Rules,让AI不再乱改代码!大家好 我是星河 最近有朋友向星河反馈 在学习使用 Cursor 编程的过程中 AI 写出的代码不够规范 而且还会乱改已经写好的代码 这个问题是可以通过 Cursor Rules 来缓解的 之前星河在文章中有简单提到过 今天就借这个机会 为大家分享一下 Cursor Rules 的原理以及用法 什么是 Cursor Rules 大语言模型不能够保证在多次会话间保留记忆 因此 Cursor 提供了 Cursor

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



大家好,我是星河。

最近有朋友向星河反馈,在学习使用Cursor编程的过程中,AI写出的代码不够规范,而且还会乱改已经写好的代码。这个问题是可以通过Cursor Rules来缓解的,之前星河在文章中有简单提到过。今天就借这个机会,为大家分享一下Cursor Rules的原理以及用法。

什么是Cursor Rules?

大语言模型不能够保证在多次会话间保留记忆。因此Cursor提供了Cursor Rules,通过在提示词级使用持久化、可复用的上下文来解决这个问题。当Cursor Rules生效时,其内容会**入到模型上下文开头,从而为AI生成代码、解释修改或辅助工作流时提供一致性指导。按官方说法,Cursor的规则“Control how the Agent model behaves with reusable, scoped instructions.”bian

Cursor主要支持两种类型的规则:用户规则(User Rules)和项目规则(Project Rules)。

另外还有一种使用.cursorrules文件来制定规则的方法。不过这种方法已经逐渐被官方放弃。如果您还在使用的话,建议尽快按“项目规则”方式进行迁移。

用户规则(User Rules)

用户规则相当于全局设置,适用于用户环境下的所有项目。在“设置->Rules->User Rules”中进行设置:

在这里,我们可以设置角色、代码规则以及一些个性化配置。星河最常用的一条设置是:

所有的回复都使用中文

我们可以对角色进行设置,比如:

你是一名经验丰富的软件开发专家和编程助手,精通各类主流编程语言与框架。 你的用户是一位独立开发者,致力于个人项目或自由职业开发任务。 你的核心职责是生成高质量代码、优化性能、并主动协助排查与解决技术问题。

我们可以对编码规范和质量做出要求,比如:

遵循架构设计,保持代码风格一致 代码修改遵循单一职责原则,不混合多个变更 在进行代码设计规划的时候,请符合“第一性原理” 在代码实现的时候,请符合“KISS原则”和“SOLID原则” 尽量复用已有代码,避免重复代码

当然,我们也可以提出一些个性化的要求,比如:

请在回复开头称呼用户为“帅哥/美女”

项目规则(Project Rules)

项目规则用于帮助理解代码库并遵循项目规范,可以被自动调用或由Agent调用,并且与代码库保持同步。规则是项目根目录下.cursor/rules目录里的一个个独立的.mdc(MarkDown Container)文件。除了手动创建以外,还可以通过以下三种方法创建规则文件:

1. 在“设置->Cursor Rules->Project Rules”里进行添加:

2. 或者使用快捷键“Ctrl+Shift+P”,搜索“New Cursor Rule”进行添加:

3. 官方还提示可以使用/Generate Cursor Rules命令来生成规则文件,不过星河用的0.48.7版本并没有这个命令,这儿使用官方视频供大家参考:

https://www.zhihu.com/video/1902433586080093886

在创建项目规则时,可以选择“规则类型(Rule Type)”:

Cursor目前支持四种不同的规则类型:

在项目规则中,我们可以按不同维度制定不同的规则文件,例如在开发管理层面,我们可以创建general.mdc来指定通用开发规范,创建git.mdc来指定git提交规范,创建doc.md来指定文档编写规范等;在编程语言层面,我们可以针对不同的语言指定不同的编码规范,例如java.mdc,cpp.mdc,python.mdc等;对于不同的技术框架,我们也可以针对性的进行规则制定,例如创建react.mdc让React组件设计和Hooks使用,创建tailwind.mdc作为Tailwind CSS样式指南等。

使用建议

官方给出的规则建议如下:

  • 聚焦:单条规则不超过500行
  • 模块化:复杂概念拆分为可组合的多条规则
  • 具体化:提供明确示例或引用文件
  • 避免模糊:像编写内部文档那样清晰表述
  • 复用:对重复使用的提示进行规则化

星河个人的理解是,Cursor Rules就是一个强制添加的提示词。既然是提示词,那么可以做的事情就很灵活了,不用局限于编程相关,可以尝试扩展规则的边界。比如星河为了更清楚的理解AI在编码过程中到底做了什么,制定的一个生成开发历史的规则:

每次会话请求结束后进行总结,
无论是生成新文件还是修改了原有内容都需要总结。
将总结的内容添加式写入到Readme文件中(说明文件中的内容是累计增加的)
总结的内容包括:

  1. 会话的主要目的
  2. 完成的主要任务
  3. 关键决策和解决方案
  4. 使用的技术栈
  5. 修改了哪些文件

    在官网cursor.directory/rules上能够看到其他用户上传的优秀规则文件,可以参考学习。也欢迎大家分享自己个性又好用的规则文件。

小讯
上一篇 2026-04-07 16:39
下一篇 2026-04-07 16:37

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/218837.html