一、规则系统的底层逻辑
Cursor 的规则系统是 AI 编程的核心控制枢纽，它通过分层配置实现了从通用规范到项目定制的无缝衔接。
全局规则（Global Rules）如同开发者的「数字指纹」，定义了贯穿所有项目的编码哲学。
一般来讲，因为全局规则会作用于所有项目，所以不宜写得过于复杂，一般有一两条就足够。
# 全局规则示例
- 始终用中文回答，包括生成git提交信息时也要使用中文
- 代码注释率不低于30%
- 函数参数必须包含类型声明项目规则（Project Rules）则是针对特定项目的「定制化契约」，通过项目根目录的.cursorrules文件实现精准控制，例如：
# React项目规则示例
- 使用Hooks替代类组件
- 路由配置文件必须包含注释说明
- 组件命名采用PascalCase规范二、智能生成的.mdc 规则文件
通过快捷命令/Generate Cursor Rules，Cursor 会自动分析项目结构并生成.mdc 规则文件，其中包含四种核心规则类型：
1. Always（始终生效规则）
这类规则如同 AI 的「金科玉律」，无论何时何地都会被严格执行。例如：
# 安全规则示例
- 所有数据库操作必须包含SQL注入防护
- 用户输入字段必须经过Joi验证
- 文件上传必须限制在10MB以内2. Auto Attached（自动关联规则）
当项目中出现特定文件类型或技术栈时，这类规则会自动激活。例如：
# TypeScript自动规则示例
- 当检测到.ts文件时，启用严格模式
- 自动生成接口定义文件
- 强制使用ES模块导入方式3. Agent Requested（智能请求规则）
AI 在处理复杂任务时会主动请求这类规则，例如：
# 微服务规则示例
- 当构建分布式系统时，启用断路器模式
- 自动生成OpenAPI文档
- 配置服务发现机制4. Manual（手动触发规则）
开发者可根据实际需求手动激活，例如：
# 性能优化规则示例
- 当执行代码重构时，启用复杂度分析
- 自动生成性能测试报告
- 建议使用缓存策略三、「花生」插件：规则生成的智能助手
「花生」插件通过预设模板和智能分析，将规则生成效率提升 300%。其核心功能包括：
1. 多场景模板库
涵盖主流开发场景的预设规则：
- 前端开发：React/Vue 组件规范、响应式设计原则
- 后端开发：Spring Boot 分层架构、数据库索引策略
- 全栈开发：前后端分离规范、API 文档生成标准
2. 智能适配机制
插件会自动识别项目技术栈并推荐相关规则，例如：
# 检测到Next.js项目时自动应用
- 使用App Router进行路由管理
- 配置环境变量安全策略
- 启用服务器组件优化3. 可视化规则管理
提供图形化界面进行规则的增删改查，支持版本控制和冲突检测：
# 规则管理界面功能
- 实时预览规则生效范围
- 对比不同版本规则差异
- 一键导出规则配置文件四、实用规则提示词示例
1. 代码质量控制
- 函数复杂度不超过10
- 单元测试覆盖率不低于80%
- 代码圈复杂度控制在15以内2. 安全开发规范
- 所有密码字段必须加密存储
- 敏感数据使用AES-256算法加密
- 接口必须包含身份验证机制3. 性能优化策略
- 数据库查询必须使用索引
- 前端资源启用CDN加速
- 接口响应时间控制在500ms以内4. 团队协作规范
- 提交信息必须包含Jira单号
- 分支命名采用feature/xxx格式
- 代码评审必须包含至少2人五、规则系统的最佳实践
- 分层配置策略：将通用规则放在全局配置，项目特定规则写入.cursorrules
- 动态调整机制：根据项目迭代定期审查规则，保持与技术栈同步
- 团队协作规范：通过 Git 共享规则文件，确保开发标准统一
- 可视化监控：利用插件提供的规则生效报告，实时追踪执行情况
通过合理运用 Cursor 的规则系统和「花生」插件，开发者可以构建高效、一致的 AI 编程范式，将更多精力投入到创造性工作中。规则系统不仅是代码质量的保障，更是提升开发效率的核心引擎。