为什么需要 Cursor Rules？
在团队协作或大型项目中，代码的一致性至关重要。Cursor Rules 就像是给 AI 发放的“员工手册”，它能约束 AI 在代码生成、重构和修复错误时的行为，避免 AI 产生“幻觉”或写出不符合项目规范的代码。
一、核心概念：User Rules vs Project Rules
Cursor Rules 分为两个层级，理解它们的区别是配置的第一步。
User Rules (用户规则)
范围： 全局生效，适用于所有项目。
适合定义你个人的通用偏好，比如“始终用中文回复”、“Python 代码使用 4 空格缩进”等。配置路径在 Settings -> Rules -> User Rules。
Project Rules (项目规则)
范围： 仅当前项目生效。
存放在项目根目录的 .cursor/rules 文件夹中。适合定义具体项目的技术栈规范，如“组件必须使用函数式编程”、“API 调用需用 try-catch 包裹”。
二、如何配置？实战操作指南
1. 配置 User Rules (全局通用)
这是最简单的上手方式。点击 Cursor 设置图标，进入 Rules 选项卡。你可以在这里输入一段自然语言描述，例如：
Be concise and avoid unnecessary explanations.
For Python code, follow PEP 8 standards.
2. 配置 Project Rules (项目级约束)
对于复杂项目，我们推荐使用文件配置。在项目根目录下创建 .cursor/rules 文件夹，并在其中创建以 .mdc 结尾的文件。
例如，创建一个 vue3-standards.mdc 文件：
# Vue 3 开发规范
## 核心原则
1. 所有组件必须使用 <script setup> 语法。
2. 禁止使用 Options API，必须使用 Composition API。
3. 样式必须使用 <style scoped>。
## 命名约定
- 组件文件名使用 PascalCase (如 UserCard.vue)。
- 事件处理函数以 handle 开头 (如 handleClick)。
三、规则的 4 种触发方式
在配置 Project Rules 时，你可以指定规则的触发时机，这让 Cursor 非常智能。
- Always 始终应用： 无论你在做什么，这条规则都会被注入到 AI 的上下文中。适用于最核心的项目规范。
- Auto Attached 自动关联： 当你打开或引用特定类型的文件（如 *.tsx, *.py）时自动触发。这是最常用的模式。
- Agent Requested 智能请求： 由 AI 根据上下文判断是否需要这条规则。你需要提供清晰的规则描述供 AI 理解。
- Manual 手动触发： 只有当你在对话中显式输入 @规则名 时才会生效。
四、最佳实践与避坑指南
- 优先级原则： 当规则发生冲突时，Project Rules 的优先级高于 User Rules。
- Git 版本控制： 强烈建议将 .cursor/rules 文件夹提交到 Git 仓库，这样团队所有成员都能享受到统一的 AI 辅助规范。
- 保持简洁： 规则描述越清晰、越具体，AI 执行得越好。避免模棱两可的形容词，多用具体的代码示例。
- 模块化管理： 不要把所有规则写在一个文件里。按技术栈（如 frontend, backend）或功能模块（如 auth, payment）拆分成多个 .mdc 文件。
总结：Cursor Rules 是让通用 AI 变成“懂你”的专属助手的关键。从设置简单的 User Rules 开始，逐步建立完善的 Project Rules 体系，你会发现编码效率会有质的飞跃。