规则
通过可重用的作用域指令控制 Agent 模型的行为。
规则为 Agent 和内联编辑提供系统级指令。可以将它们视为项目的持久上下文、偏好设置或工作流程。
Cursor 支持三种类型的规则：
像
许多示例可从提供商和框架获得。社区贡献的规则可在在线众包集合和存储库中找到。
项目根目录中的
项目规则
存储在
.cursor/rules 中，受版本控制并作用于您的代码库。用户规则
全局应用于您的 Cursor 环境。在设置中定义并始终生效。
.cursorrules（旧版）
仍然支持，但已弃用。请改用项目规则。
规则的工作原理
大型语言模型在不同的补全之间不会保留记忆。规则在提示级别提供持久的、可重用的上下文。 当应用时，规则内容会包含在模型上下文的开始部分。这为AI提供了一致的指导，用于生成代码、解释编辑或协助工作流程。项目规则
项目规则存储在.cursor/rules 中。每个规则都是一个文件并受版本控制。它们可以使用路径模式进行范围限定，手动调用，或基于相关性包含。子目录可以包含自己的 .cursor/rules 目录，范围限定到该文件夹。
使用项目规则来：
- 编码关于代码库的领域特定知识
- 自动化项目特定的工作流程或模板
- 标准化样式或架构决策
规则结构
每个规则文件都用 MDC (.mdc) 编写，这是一种支持元数据和内容的格式。通过类型下拉菜单控制规则的应用方式，这会改变属性 description、globs、alwaysApply。
| 规则类型 | 描述 |
|---|---|
Always | 始终包含在模型上下文中 |
Auto Attached | 当引用匹配 glob 模式的文件时包含 |
Agent Requested | 对 AI 可用，由 AI 决定是否包含。必须提供描述 |
Manual | 仅在使用 @ruleName 显式提及时包含 |
@service-template.ts 这样的引用文件在规则触发时作为额外上下文包含。
嵌套规则
通过在整个项目的.cursor/rules 目录中放置规则来组织规则。当引用其目录中的文件时，嵌套规则会自动附加。
创建规则
使用New Cursor Rule 命令或转到 Cursor Settings > Rules 来创建规则。这会在 .cursor/rules 中创建一个新的规则文件。从设置中，您可以看到所有规则及其状态。
生成规则
使用/Generate Cursor Rules 命令直接在对话中生成规则。当您对代理行为做出决策并希望重复使用它们时很有用。
最佳实践
好的规则应该是专注的、可操作的和有明确范围的。- 保持规则在500行以内
- 将大型规则拆分为多个可组合的规则
- 提供具体的示例或引用文件
- 避免模糊的指导。编写规则时要像清晰的内部文档一样
- 在聊天中重复提示时重用规则
示例
前端组件和 API 验证标准
前端组件和 API 验证标准
此规则为前端组件提供标准：在 components 目录中工作时：
- 始终使用 Tailwind 进行样式设计
- 使用 Framer Motion 进行动画
- 遵循组件命名约定
- 使用 zod 进行所有验证
- 使用 zod schemas 定义返回类型
- 导出从 schemas 生成的类型
Express 服务和 React 组件模板
Express 服务和 React 组件模板
此规则为 Express 服务提供模板：创建 Express 服务时使用此模板：
- 遵循 RESTful 原则
- 包含错误处理中间件
- 设置适当的日志记录
- Props 接口在顶部
- 组件作为命名导出
- 样式在底部
自动化开发工作流程和文档生成
自动化开发工作流程和文档生成
此规则自动化应用分析：当被要求分析应用时：
- 使用
npm run dev运行开发服务器 - 从控制台获取日志
- 建议性能改进
- 提取代码注释
- 分析 README.md
- 生成 markdown 文档
在 Cursor 中添加新设置
在 Cursor 中添加新设置
首先在 要在应用中使用，导入 reactiveStorageService 并使用该属性：
@reactiveStorageTypes.ts 中创建一个要切换的属性。在 @reactiveStorageService.tsx 的 INIT_APPLICATION_USER_PERSISTENT_STORAGE 中添加默认值。对于 beta 功能，在 @settingsBetaTab.tsx 中添加切换，否则在 @settingsGeneralTab.tsx 中添加。切换可以作为 <SettingsSubSection> 添加用于常规复选框。查看文件的其余部分以获取示例。用户规则
用户规则是在 Cursor Settings → Rules 中定义的全局偏好设置，适用于所有项目。它们是纯文本格式，非常适合设置首选的沟通风格或编码约定：.cursorrules (已弃用)
项目根目录中的 .cursorrules 文件仍然受支持，但将被弃用。我们建议迁移到项目规则以获得更多控制、灵活性和可见性。
常见问题
为什么我的规则没有生效？
为什么我的规则没有生效？
检查规则类型。对于
Agent Requested，确保已定义描述。对于 Auto Attached，确保文件模式匹配引用的文件。规则可以引用其他规则或文件吗？
规则可以引用其他规则或文件吗？
可以。使用
@filename.ts 将文件包含在规则的上下文中。我可以从聊天中创建规则吗？
我可以从聊天中创建规则吗？
可以，使用
/Generate Cursor Rules 命令从聊天中生成项目规则。如果启用了记忆功能，记忆会自动生成。规则会影响 Cursor Tab 或其他 AI 功能吗？
规则会影响 Cursor Tab 或其他 AI 功能吗？
不会。规则仅适用于 Agent 和 Inline Edit