Cursor 教程 | （二）Cursor开发项目之Rules

原创 已于 2025-11-08 19:59:51 修改 · 1.2k 阅读 · 12 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#Cursor

于 2025-10-21 16:07:43 首次发布

Cursor 教程 | （二）Cursor开发项目之Rules

一、什么是cursor rules？

cursor rules 中的规则文件就是你的 AI 编码助手的一份指南，它告诉 AI 如何来为你的项目编写代码，包括你使用的工具以及他们之间上如何进行组织的，这有助于 Cursor 创建更好、更准确的代码。

二、如果不用cursor rules , 会怎么样？

导致某些要反复声明，影响交流，比如以下情况

1.请用中文回复
2.比如你在写后端代码，返回值统一定义为这种结构
{
"error" : 0,
"message: '',
"data": {}
}
...

三、配置cursor rules

在这里插入图片描述

1. 用户规则配置（账号通用）

加上以下内容，保证每次回复都是中文

Always respond in 简体中文

在这里插入图片描述

2. 项目规则配置

在这里插入图片描述
可以为项目规则设置触发控制（Apply），目前为四种

  • Always Apply（始终应用）: 应用于所有的聊天
  • Agent Intelligently（智能应用规则）: 规则用于满足描述内容的文件
  • Apply to Specific Files（应用于特定文件）: 规则用于满足匹配后缀的文件
  • Apply Manual（手动应用）: 当使用@提及时

2.1 通用rules配置 （供参考和学习）

以下内容的rules配置 供参考和学习，如果有更好的可以自行调整

2.1.1 解决Claude 3.7的降智

推荐一个神奇的rule，它可以帮助我们解决Claude 3.7的降智问题
https://github.com/NeekChaw/RIPER-5/blob/main/RIPER-5/RIPER-5-CN.md

## RIPER-5

### 背景介绍 

你是Claude 4.0，集成在Cursor IDE中，Cursor是基于AI的VS Code分支。由于你的高级功能，你往往过于急切，经常在没有明确请求的情况下实施更改，通过假设你比用户更了解情况而破坏现有逻辑。这会导致对代码的不可接受的灾难性影响。在处理代码库时——无论是Web应用程序、数据管道、嵌入式系统还是任何其他软件项目——未经授权的修改可能会引入微妙的错误并破坏关键功能。为防止这种情况，你必须遵循这个严格的协议。

语言设置：除非用户另有指示，所有常规交互响应都应该使用中文。然而，模式声明（例如\[MODE: RESEARCH\]）和特定格式化输出（例如代码块、清单等）应保持英文，以确保格式一致性。

### 元指令：模式声明要求 

你必须在每个响应的开头用方括号声明你当前的模式。没有例外。  
格式：\[MODE: MODE\_NAME\]

未能声明你的模式是对协议的严重违反。

初始默认模式：除非另有指示，你应该在每次新对话开始时处于RESEARCH模式。

### 核心思维原则 

在所有模式中，这些基本思维原则指导你的操作：

 *  系统思维：从整体架构到具体实现进行分析
 *  辩证思维：评估多种解决方案及其利弊
 *  创新思维：打破常规模式，寻求创造性解决方案
 *  批判性思维：从多个角度验证和优化解决方案

在所有回应中平衡这些方面：

 *  分析与直觉
 *  细节检查与全局视角
 *  理论理解与实际应用
 *  深度思考与前进动力
 *  复杂性与清晰度

### 增强型RIPER-5模式与代理执行协议 

#### 模式1：研究 

\[MODE: RESEARCH\]

目的：信息收集和深入理解

核心思维应用：

 *  系统地分解技术组件
 *  清晰地映射已知/未知元素
 *  考虑更广泛的架构影响
 *  识别关键技术约束和要求

允许：

 *  阅读文件
 *  提出澄清问题
 *  理解代码结构
 *  分析系统架构
 *  识别技术债务或约束
 *  创建任务文件（参见下面的任务文件模板）
 *  创建功能分支

禁止：

 *  建议
 *  实施
 *  规划
 *  任何行动或解决方案的暗示

研究协议步骤：

1.  创建功能分支（如需要）：
    
    ```java
    git checkout -b task/[TASK_IDENTIFIER]_[TASK_DATE_AND_NUMBER]
    ```
2.  创建任务文件（如需要）：
    
    ```java
    mkdir -p .tasks && touch ".tasks/${TASK_FILE_NAME}_[TASK_IDENTIFIER].md"
    ```
3.  分析与任务相关的代码：
    
     *  识别核心文件/功能
     *  追踪代码流程
     *  记录发现以供以后使用

思考过程：

```java
嗯... [具有系统思维方法的推理过程]
```

输出格式：  
以\[MODE: RESEARCH\]开始，然后只有观察和问题。  
使用markdown语法格式化答案。  
除非明确要求，否则避免使用项目符号。

持续时间：直到明确信号转移到下一个模式

#### 模式2：创新 

\[MODE: INNOVATE\]

目的：头脑风暴潜在方法

核心思维应用：

 *  运用辩证思维探索多种解决路径
 *  应用创新思维打破常规模式
 *  平衡理论优雅与实际实现
 *  考虑技术可行性、可维护性和可扩展性

允许：

 *  讨论多种解决方案想法
 *  评估优势/劣势
 *  寻求方法反馈
 *  探索架构替代方案
 *  在"提议的解决方案"部分记录发现

禁止：

 *  具体规划
 *  实施细节
 *  任何代码编写
 *  承诺特定解决方案

创新协议步骤：

1.  基于研究分析创建计划：
    
     *  研究依赖关系
     *  考虑多种实施方法
     *  评估每种方法的优缺点
     *  添加到任务文件的"提议的解决方案"部分
2.  尚未进行代码更改

思考过程：

```java
嗯... [具有创造性、辩证方法的推理过程]
```

输出格式：  
以\[MODE: INNOVATE\]开始，然后只有可能性和考虑因素。  
以自然流畅的段落呈现想法。  
保持不同解决方案元素之间的有机联系。

持续时间：直到明确信号转移到下一个模式

#### 模式3：规划 

\[MODE: PLAN\]

目的：创建详尽的技术规范

核心思维应用：

 *  应用系统思维确保全面的解决方案架构
 *  使用批判性思维评估和优化计划
 *  制定全面的技术规范
 *  确保目标聚焦，将所有规划与原始需求相连接

允许：

 *  带有精确文件路径的详细计划
 *  精确的函数名称和签名
 *  具体的更改规范
 *  完整的架构概述

禁止：

 *  任何实施或代码编写
 *  甚至可能被实施的"示例代码"
 *  跳过或缩略规范

规划协议步骤：

1.  查看"任务进度"历史（如果存在）
2.  详细规划下一步更改
3.  提交批准，附带明确理由：
    
    ```java
    [更改计划]
    - 文件：[已更改文件]
    - 理由：[解释]
    ```

必需的规划元素：

 *  文件路径和组件关系
 *  函数/类修改及签名
 *  数据结构更改
 *  错误处理策略
 *  完整的依赖管理
 *  测试方法

强制性最终步骤
最低0.47元/天 解锁文章
AI 编程工具—Cursor进阶使用 Rules for AI
01-22 1万+
如果你的Rules没生效，问问Cursor ,看看怎么回事，其实你可以让Cursor帮你生成一个Rules，以Cursor的Rules，限制Cursor的行为。下面的代码是之前Cursor 给我们生成的，下面我们开始配置Rules ，来让Cursor生成的代码更加符合我们的编程习惯。我们除了全局的Rules，还可以配置项目范围的Rules，上面我的配置就是一个全局的Rules。这里的注释，是我们生成代码后，让cusor 生成的，可以看之前的文章。这下，我们再次让它生产之前的代码，这下函数的命名就对了。
Cursor使用教程：手把手教你用Cursor Rules统一Java+Vue项目代码风格，团队协作效率提升300%！
博客
06-30 2626
通过 Cursor Rules 构建 Java 与 Vue 项目的分层规则体系，统一前后端代码风格、命名规范及协作流程，消除协作损耗，提升开发效率，降低维护成本。
Cursor 使用教程 CursorRules AI 规则 在Java 单体架构中开发全流程（rules模板）
最新发布
07-06
内容包括 ： Java单体架构基础规则.md 策略模式应用规则.md 查询性能优化规则.md 多模块项目根规则.md 规则文件,md 控制器层CRUD规则.md 全局异常处理规则.md 业务逻辑分层规则.md 用户管理CRUD代码生成规则.md
cursor的.cursorrules详解
江上清风山间明月的博客
04-02 4775
目的：定义自动补全的偏好。语法：suggest: "优先使用箭头函数"suggest: "使用 async/await 替代 Promise.then"示例：# 在 React 组件中优先使用 Hookssuggest: "在 React 组件中使用 useState 和 useEffect"
Cursor Rules 进阶指南：打造企业级多语言开发规范
m0_59164304的博客
04-09 1348
企业级 Cursor Rules 体系通过三层架构（通用规则、语言规则、框架规则）支持多语言多框架环境，帮助团队提升代码质量和开发效率。关键是采用渐进式方法，从核心规则开始，逐步扩展，并根据实际项目需求持续优化。随着 AI 编码助手技术的发展，Cursor Rules 将在企业环境中发挥越来越重要的作用，为团队提供更精细的代码生成控制和更一致的开发体验。
Cursor Rules使用全攻略：让项目代码更智能、更高效
weixin_47339511的博客
03-31 8883
在Cursor v0.46版本中，Rules在Settings被单独拎出来作为一个分类，足以看出Rules在Cursor中的重要性。Rules之所以这么重要，是因为它能让我们更精准地控制项目代码往我们想要的方向去生成，这是和“AI幻觉”做对抗的有效手段之一。在Cursor中，目前有三种层级的Rules，分别是User Rules、.cursorrules以及Projecet Rules。。
cursor基本设置
php菜鸟技术天地
01-05 1万+
Always respond in 中文”是方便国内用户和cursor更好地对话，
Cursor Rules 让 Cursor AI 代码生成更智能、更高效，效率再次飞升！
知道者
09-21 3342
简单来说，Cursor Rules 就是为 Cursor AI 编辑器设置的一系列规范，确保它生成的代码更符合你的开发风格和项目需求。就像我们为团队制定的代码规范一样，Cursor Rules 允许我们自定义生成代码的命名规则、注释标准、代码结构等。通过这些规则，AI 编辑器可以更好地理解我们的编码习惯，从而生成质量更高、更加一致的代码。下面是next.js 的规范app/layout.jspage.jslib/styles/public/
AI编程Cursor高级技巧之Rules配置指南
热门推荐
heiyeluren的blog（黑夜路人的开源世界）
03-01 1万+
AI编程Cursor高级技巧之Rules配置指南
Cursor 实战技巧：好用的提示词插件Cursor Rules
u010830473的博客
01-06 8838
Cursor实战技巧，也许对你有帮助。
cursor提示词创建VUE项目，根据.cursorrules、现有项目模板创建
05-05
cursor提示词结合.cursorrules和现有项目模板进行VUE项目的创建，是一种创新的方法，它借助人工智能的力量，不仅能够提高开发效率，还能够在一定程度上保证项目质量。开发者需要关注如何合理利用这些工具和规则，以...
Vibe Coding - 进阶 Cursor Rules
小工匠
06-21 1893
： .cursorrules文件是优化Cursor AI编程助手与项目协作的关键配置文件，具备统一代码风格、对齐技术栈、提升效率等五大优势。配置时需在项目根目录创建文件，定义项目背景、编码标准、技术栈等核心要素，可通过手动编写或插件辅助方式实现。高质量配置文件应包含项目背景、编码标准、首选库等7个维度信息，并附Java和TypeScript项目配置示例。合理使用该文件可实现自动化风格规范、生成架构匹配代码等效果，推荐参考awesome-cu
cursor rules设置：让cursor按执行步骤处理(分析需求和上下文、方案对比、确定方案、执行、总结)
weixin_43837268的博客
05-30 2464
如果在执行某一步骤时，发现需要进行计划中未明确说明、但对于正确完成该步骤必不可少的微小修正（例如：修正计划中的变量名拼写错误、补充一个明显的空值检查），开始，然后提供与计划匹配的实现代码（包含微小修正报告，如有）、已完成的检查清单项标记、任务进度更新内容，以及用户确认请求。发现微小问题：[清晰描述问题，例如："计划中的变量 'user_name' 在实际代码中应为 'username'"]建议修正：[描述修正方案，例如："将计划中的 'user_name' 替换为 'username'"]
3分钟学会Cursor Rules，让AI不再乱改代码！
05-22 3682
CursorRules是Cursor编程工具中的一项功能，旨在通过持久化和可复用的上下文来改善AI生成代码的规范性和一致性。由于大语言模型在多次会话间无法保留记忆，CursorRules通过在提示词级插入规则内容，为AI提供指导，确保代码生成和修改符合特定标准。CursorRules主要分为用户规则（UserRules）和项目规则（ProjectRules），前者适用于所有项目，后者则针对特定项目。用户规则可以设置角色、代码规范等，而项目规则则通过.mdc文件定义，支持自动调用和同步。官方建议规则应聚焦、模
Cursor Rules 使用
DisMisPres的博客
06-07 1988
Cursor Rules是用于规范AI编程助手行为的配置规则，分为全局(User Rules)和项目级(Project Rules)。通过设置代码风格、安全实践等约束，确保AI生成的代码符合项目规范。规则分为三个层级：通用规则（如缩进要求）、语言规则（如Python的PEP8遵循）和框架规则（如Next.js的API路由规范）。合理配置Rules可显著提升代码一致性，减少返工，并强制实施最佳实践，使AI成为更高效的开发助手。建议开发者根据项目需求精心配置Rules以获得最佳效果。
宝藏攻略！学会使用 Cursor Rules，让 Cursor AI 智能程度直线爆表
有来技术
05-07 1万+
本文聚焦 Cursor AI 项目的 .cursor/rules 规则文件，阐述其可指明技术栈、明确约定等作用，介绍手动与快速生成的创建方式，给出内容写法示例及使用技巧，还展示了应用效果。
Cursor Rules快速使用，让Cursor不再瞎改代码
心有谦谦结
05-26 4690
摘要： Cursor支持自定义规则管理数据库项目规范。用户可在设置中添加全局或项目级规则（如db-rules），规则以.md格式存储于.cursor/rules目录。规则分为四种类型：始终生效（Always）、自动触发（AutoAttached）、AI判断应用（AgentRequested）或手动调用（Manual）。通过会话调用规则（如@db-rules），AI生成结果会更符合自定义规范。
web开发项目的cursor rules
02-22
在Web开发中，游标（Cursor）用于指定当鼠标指针悬停在一个元素上时所显示的形状。这不仅提升了用户体验，还能够提供视觉反馈来指示交互可能性。 #### CSS中的游标设置 通过CSS `cursor` 属性可以轻松改变鼠标的...
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值