文件位置
项目规则通常放在仓库里的 .cursor/rules 目录。第一个常见文件是 project.mdc。
.cursor/rules/project.mdc
可用示例
内容要直接、可执行。
--- description: Project coding rules globs: ["**/*"] --- Use TypeScript for app code. Run npm test before final handoff. Keep components small and prefer existing UI patterns.
常见错误
弱规则通常太宽泛或已经过期。
- 不要复制整份 README。
- 不要把关键测试命令藏在旧聊天记录里。
- 不要写和 formatter 或 lint 配置冲突的规则。
常见问题
Cursor Rules 应该提交到仓库吗？
项目规则通常应该提交，让团队共享同一份指导。
规则文件应该多长？
短到容易扫读，同时优先写稳定命令和约定。
规则能只针对仓库一部分吗？
可以。用 globs 针对需要特殊指导的 package、框架或文件类型。