X记录空间前言
很多开发者第一次使用 Cursor 时都会产生一个疑问：
为什么同样的问题，有时候生成的代码质量很高，有时候却完全不符合项目规范？
实际上，大多数问题并不在模型，而在于 Cursor 缺少项目规则。
Cursor Rules 的作用，就是让 AI 理解项目约束，从而生成更加稳定、一致的代码。
对于长期项目来说，Rules 的重要性甚至不亚于模型本身。
为什么需要 Cursor Rules？
默认情况下，AI 只知道：
- 当前代码
- 当前上下文
它并不知道：
- 命名规范
- 目录结构
- 技术栈
- 组件风格
因此经常出现：
Composition API 和 Options API 混用
TypeScript 类型不统一
文件位置错误
命名不规范
重复代码
随着项目变大，这些问题会越来越明显。
Rules 的本质：
是给 AI 提供长期记忆。
Cursor Rules 的工作机制
可以理解成：
用户需求
↓
Cursor Rules
↓
模型
↓
生成代码
Rules 永远优先于普通 Prompt。
因此：
一个好的 Rules 文件，可以持续影响整个项目。
推荐目录结构
建议放在：
.cursor/rules
或者：
.cursor/rules.md
便于团队维护。
不要把所有规则写在一个超长文件中。
推荐拆分：
frontend.md
backend.md
style.md
database.md
提高可维护性。
Vue3 项目推荐 Rules
例如：
始终使用：
- Composition API
禁止：
- Options API
使用：
- TypeScript
组件命名：
PascalCase
接口目录：
src/api
页面目录：
src/views
公共组件：
src/components
这样生成的代码会更加统一。
React 项目推荐 Rules
约束：
- Function Component
- TypeScript
- Hook 优先
禁止：
Class Component
状态管理：
推荐：
zustand
而不是：
redux
避免生成不符合项目习惯的代码。
Prompt 和 Rules 的区别
Prompt：
只影响当前任务。
Rules：
影响整个项目。
例如：
Prompt：
创建用户管理页面
Rules：
规定：
- 使用 TypeScript
- 使用 Axios
- 使用 Tailwind
因此最终生成结果更加稳定。
不要把 Rules 写得太复杂
很多开发者喜欢：
写几十页规则。
结果：
模型反而容易混乱。
推荐：
控制在：
100~300 行。
重点描述：
- 技术栈
- 命名规范
- 目录结构
- 禁止事项
即可。
Agent 模式与 Rules
Agent 模式会读取 Rules。
因此：
Rules 的质量直接决定 Agent 的能力。
如果 Rules 不明确。
Agent 很容易：
- 创建错误目录
- 使用错误框架
- 重复代码
这是很多人误以为：
Cursor 不够智能的真正原因。
最佳实践
不要追求完美 Rules。
随着项目演进逐步优化。
建议：
每解决一个问题。
就把经验加入 Rules。
长期下来。
AI 会越来越像了解项目的团队成员。
结语
很多开发者把注意力放在模型上。
实际上：
Rules 才是提高 Cursor 效率的关键。
模型决定上限。
Rules 决定下限。
当项目越来越复杂时，一个优秀的 Rules 文件所带来的收益，远远超过更换模型。
