规则
用可复用且有作用域的指令，控制 Agent 模型的行为。
规则为 Agent 和 Inline Edit 提供系统级指令。可以把它们看作项目的持久化上下文、偏好或工作流。
Cursor 支持四种类型的规则：
大型语言模型在不同补全之间不会保留记忆。规则在提示层提供持久、可复用的上下文。
应用后，规则内容会被置于模型上下文的开头。这为 AI 提供一致的指导，用于生成代码、理解编辑，或协助处理工作流。
通过在项目各处的
使用 
来自各个提供者和框架的示例非常丰富。社区贡献的规则可在众包集合和在线仓库中找到。
用户规则是在 Cursor Settings → Rules 中定义的全局偏好设置，适用于所有项目。它们为纯文本，非常适合用于设定偏好的沟通风格或编码规范：
你项目根目录中的
Project Rules
存在
.cursor/rules 中，受版本控制，作用范围限定在你的代码库内。User Rules
作用于你的 Cursor 全局环境。在设置中定义并始终生效。
AGENTS.md
用 Markdown 编写的 Agent 指令，是
.cursor/rules 的简化替代方案。.cursorrules (Legacy)
仍受支持，但已弃用。请改用 Project Rules。
规则的工作方式
规则适用于 Chat 和 Inline
Edit。已启用的规则会显示在 Agent 侧边栏。
项目规则
.cursor/rules。每条规则都是一个文件，并纳入版本控制。它们可以通过路径模式限定作用域、手动触发，或按相关性自动包含。子目录也可以放置各自的 .cursor/rules 目录，仅作用于该文件夹。
用项目规则来：
- 编码与你代码库相关的领域知识
- 自动化项目特定的工作流或模板
- 统一风格或架构决策
规则结构
.mdc）编写，这是一种同时支持元数据和内容的格式。通过类型下拉菜单控制规则的应用方式，该操作会更改 description、globs、alwaysApply 属性。
| 规则类型 | 描述 |
|---|---|
Always | 始终包含在模型上下文中 |
Auto Attached | 当引用与某个 glob 模式匹配的文件时包含 |
Agent Requested | 提供给 AI，由其决定是否包含。必须提供描述 |
Manual | 只有在使用 @ruleName 明确提及时才会包含 |
嵌套规则
.cursor/rules 目录中放置规则来组织它们。当引用其目录中的文件时，嵌套规则会自动附加。
创建规则
New Cursor Rule 命令，或前往 Cursor Settings > Rules 创建规则。这样会在 .cursor/rules 中创建一个新的规则文件。在设置里你能查看所有规则及其状态。
生成规则
/Generate Cursor Rules 命令生成规则。当你已经对 agent 的行为做出决策并想要复用它们时，这很有用。
最佳实践
- 将规则控制在 500 行以内
- 把大型规则拆分成多个可组合的规则
- 提供具体示例或引用的文件
- 避免模糊的指导。像清晰的内部文档一样写规则
- 在聊天中重复提示时复用规则
示例
前端组件规范与 API 校验
前端组件规范与 API 校验
该规则提供前端组件的规范：在 components 目录开发时：
- 样式一律使用 Tailwind
- 动画使用 Framer Motion
- 遵循组件命名约定
- 所有校验使用 zod
- 使用 zod schema 定义返回类型
- 导出由 schema 生成的类型
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> 添加。参考文件其余部分的示例。AGENTS.md
AGENTS.md 是一个用于定义代理指令的简单 markdown 文件。把它放在项目根目录，作为 .cursor/rules 的替代方案，适用于简单直观的场景。
与 Project Rules 不同，AGENTS.md 是不含元数据或复杂配置的纯 markdown 文件。它非常适合需要简洁、易读指令、且不想引入结构化规则开销的项目。
当前限制
- 仅限根目录：
AGENTS.md必须放在项目根目录（v1.5） - 无作用域：指令在整个项目中全局生效
- 单文件：不同于
.cursor/rules，你不能将指令拆分到多个文件
子目录中嵌套的
AGENTS.md 支持计划在 v1.6 提供。用户规则
.cursorrules（旧版）
.cursorrules 文件依然受支持，但会被弃用。建议迁移到 Project Rules，以获得更强的可控性、灵活性和可见性。
常见问题
为什么我的规则没有生效？
为什么我的规则没有生效？
检查规则类型。对于
Agent Requested，确保已填写描述。对于 Auto Attached，确保文件匹配模式与被引用的文件一致。规则可以引用其他规则或文件吗？
规则可以引用其他规则或文件吗？
可以。使用
@filename.ts 把文件加入规则的上下文。我可以在聊天里创建规则吗？
我可以在聊天里创建规则吗？
可以，用
/Generate Cursor Rules 命令在聊天中生成项目规则。如果启用了 Memories，会自动生成相应的记忆。规则会影响 Cursor Tab 或其他 AI 功能吗？
规则会影响 Cursor Tab 或其他 AI 功能吗？
不会。规则只适用于 Agent 和 Inline Edit。