学习目标
创建一条作用范围明确、可以随仓库维护的项目规则。
- 真实约定
选一项反复出现、能用改动结果验证的项目写法。
- 创建规则
通过 New Cursor Rule 生成 .cursor/rules/ 下的 .mdc 文件。
- 限定范围
用 globs 匹配真实目录，局部约定不设为 Always Apply。
- 双向验证
匹配目录内生效，无关任务不被额外约束干扰。
规则的价值在于该出现时才出现，而不是所有任务都常驻加载。
适用场景
Cursor 经常采用与项目不一致的组件写法，或者把前端约定带到后端文件里。
准备条件
- 已在 Cursor 打开目标仓库。
- 能指出一项已确认的项目约定，以及它适用的目录。
操作步骤
只选一项反复出现的约定
先明确这条规则解决什么真实问题。例如“表单页面复用现有校验组件”，比“代码要优雅”更容易执行和验证。
用官方入口创建项目规则
打开命令面板，搜索 New Cursor Rule。项目规则保存在 .cursor/rules/，文件扩展名使用 .mdc，便于按仓库维护。
为规则限定范围
通过规则界面的类型和文件匹配控制应用时机。下面只是一个结构示例，globs 应换成项目真实目录。
.cursor/rules/forms.mdc 示例--- description: 修改前端表单时遵循现有校验方式 globs: "src/components/forms/**/*.tsx" alwaysApply: false --- 先查看同目录已有表单和校验组件。 复用项目现有的错误提示与提交状态。 保留输入为空、提交中与请求失败的行为。用相关与无关任务分别检查
在匹配目录做一次小改动，核对规则是否适用；再查看非匹配任务，避免把所有局部规则都设为始终加载。
常见误区
- 所有规则都设成 Always Apply
- 只有全项目都适用的稳定约定才始终加载；局部规则限定目录。
- 把 .md 文件放进 rules 目录就以为生效
- 使用项目规则支持的 .mdc 格式，或按官方说明选择 AGENTS.md 方式。
验收清单
- 规则文件实际位于 .cursor/rules/ 且使用 .mdc。
- 匹配目录是真实路径，描述说明了适用任务。
- 生成的改动遵循该规则，且不会给无关目录添加多余约束。
资料与版本
本文为原创整理，示例需按项目调整；工具界面与功能以当前版本为准。