Cursor Rules 最佳实践总结
Eric深入解析 Cursor Rules 机制，总结通用规则、Project Rules、语言专属规则与私有规则四层实战体系。
使用 AI 编写代码的一大问题就是 AI 乱改，Cursor 引入了一项功能，称为 Cursor Rules。它能允许开发者规范 AI 的行为，提供更好的编码体验。让我们深入了解 Cursor Rules 是什么，以及为什么它们对现代开发工作流程至关重要。
什么是 Cursor Rules？
Cursor Rules 用于自定义 AI 在 Cursor 中的行为，可以视为对大型语言模型（LLM）的指令或系统提示。Cursor支持两种类型的规则设置：
- 全局规则：在Cursor设置中的
Rules > User Rules设置，适用于所有项目。 - 项目规则：通过
.cursor/rules目录中的.mdc文件或项目根目录的.cursorrules文件设置。
官方建议采用 Project Rules 的.cursor/rules 目录来管理规则文件，.cursorrules文件将在未来版本被废弃。
最佳实践
如果你现在采用的是.currorrules 文件，可以将其分类拆分到不同的文件当中。我现在以一个实际项目，Cursor 版本为 0.47.5 为例。
01 通用规则
新建 .cursor/rules.general.mdc 文件，包含项目的基本信息和通用规范。设置RuleType为Always，将在所有的聊天框中应用。主要包含：技术栈、代码风格、项目结构等通用信息。
02 Python 规则
该项目主要是python为主的语言，根据项目实际需求可以换成Java/React/Typescript等。新建一个.cursor/rules/python.mdc 文件，Rule Type 采用 Auto Attached，文件后缀为*.py。主要包含Python的编码规范和最佳实践等。
03 文档规则
新建一个 .cursor/rules/document.mdc，针对文档文件的规范。
04 Git 规则
新建一个.cursor/rules/git.mdc文件，针对Git操作的规范，包含提交规范、分支管理等。
最后
- 如果您是新用户，直接使用Project Rules。
- 如果您有现有的.cursorrules文件，尽快迁移到Project Rules。
- 使用Project Rules的高级功能来更精确地控制AI行为。
- 将规则文件纳入版本控制，与团队共享。
- 根据项目需求创建多个规则文件，而不是将所有规则放在一个文件中。
- 规则需要定时进行 Review 和 改进。
最后就算你使用了Cursor Rules，有时候它不一定会按照你的规则进行编写代码。就像我规则中写了不要自动提交git代码，它有时候偶尔还是会改动完成后，你还没有accpet这些文件，却被直接提交到了远程仓库。
Cursor Rules 专题推荐
如果你对 Cursor Rules 与上下文规范化感兴趣，可以阅读同专题的更多实战：
- Cursor Rules 进阶指南：打造企业级多语言开发规范
- Cursor Notepads 最佳实践总结
- Cursor 0.49.x 自动生成 Project Rules 实用指南
- Cursor Rules 的一次全面总结
- Cursor Rules 四大原则：让 AI 代码生成更稳定高效
👉 查阅更多实战技巧，欢迎访问 Cursor 专栏完整目录。
