Cursor AI乱改代码？正确使用Rules是关键

你是否在使用 Cursor 时常常遇到 AI 胡乱修改代码、答非所问，甚至将之前写好的逻辑搞崩溃？其实，这往往是因为你没有正确配置 Cursor Rules。掌握 Cursor Rules，就能让你的 AI 代码生成更加精准高效，大幅提升开发效率。

本教程将系统讲解 Cursor Rules 的完整定义、核心用法、编写技巧与实战案例，帮助你轻松驾驭 AI 编程助手，充分发挥其潜力。

Cursor Rules 本质上是一种规则文件。在使用 AI 编程时，模型无法长期保持上下文，而 Rules 文件能够提供持久且可复用的上下文信息，每次与模型交互时自动携带。简而言之，它就像一本专属的“操作手册”，指导 AI 如何理解你的项目结构、遵循编码规范。

当前，Cursor Rules 主要分为以下三种类型：

• Project Rules：项目级规则，仅对当前项目的所有对话生效。

• User Rules：用户级规则，适用于该用户所有项目的全部对话。

• .cursorrules（即将被废弃）

温馨提示：当前官方推荐使用 Rules 替代 .cursorrules，因为 Rules 支持更灵活的管理方式，例如能够根据文件类型自动匹配，并允许 AI 自主判断是否生效。

首先，请确保已安装 Cursor。若尚未安装，请前往官方网站下载：

安装完成后，启动 Cursor，点击菜单栏中的“设置”（Settings）选项：

切换到 Rules 面板，即可查看当前的 User Rules 和 Project Rules 列表：

点击 Add new rule 按钮，即可创建新规则：

规则文件是以 .mdc 为后缀的特殊文件，其中包含 Rule Type（规则类型），主要分为以下几种：

• Always：规则会持续存在于模型上下文中，适用于全局规范，例如命名风格、编码习惯等。

• Auto Attached：当匹配到规则文件（通过自定义 glob）时，自动附加该规则，非常适合特定技术栈或文件类型的规则。

• Agent Requested：由 AI 自主决定是否包含规则，需提供 description，AI 会根据描述判断是否适用。

• Manual：需要手动通过 @规则 方式激活，适合临时或不常用的规则。

常见问题：如何选择合适的 Rule Type？

• 若规则适用于整个项目（如代码风格），推荐使用 Always。
• 若规则仅针对特定文件（如 .tsx、.py），建议选择 Auto Attached，让 AI 自动匹配。
• 如果不确定，可先设为 Agent Requested，观察 AI 是否自动调用。

在 Cursor 0.49 版本中，新增了 AI 自动生成规则 的功能。只需在 Agent 中输入 /Generate Cursor Rules，系统便会自动生成 .mdc 文件：

要编写高质量的 Cursor Rules，推荐参考以下资源网站：

该网站收录了大量高质量的 Cursor Rules，涵盖多种编程语言和技术栈。接下来，通过几个经典案例，学习如何编写自己的专属规则。

案例一：Tailwind + Shadcn + Radix 技术栈规则编写

这是最受欢迎的规则之一，主要由三个核心部分组成：

1. 角色定义：明确 AI 的身份角色及其擅长的技术栈。

2. 工作要求：规定 AI 需遵循的工作规范，例如思考方式、代码质量标准等。

3. 技术规范：明确使用的技术栈、代码风格、命名惯例等。

以下是完整的规则代码示例：

你是一名资深前端开发工程师，精通ReactJS、NextJS、JavaScript、TypeScript、HTML、CSS以及现代UI/UX框架（如TailwindCSS、Shadcn、Radix）。你思维缜密，能够提供细致深入的回答，并且在逻辑推理方面表现卓越。你会谨慎地给出准确、真实、经过深思熟虑的答案，堪称推理专家。

- 严格遵循用户的要求执行。
- 首先逐步思考——用伪代码详细描述构建计划。
- 确认无误后再编写代码！
- 始终编写正确、符合最佳实践、遵循DRY原则（避免重复）、无错误、功能完整且可正常运行的代码，同时遵守下方列出的代码实现指南。
- 注重代码的简洁性和可读性，而非过度追求性能优化。
- 完整实现所有请求的功能。
- 不得留下任何待办事项、占位符或缺失部分。
- 确保代码完整！彻底验证并最终完成。
- 包含所有必要的导入，并确保关键组件命名正确。
- 尽量简洁，减少不必要的文字说明。
- 如果认为可能没有正确答案，请明确指出。
- 如果不知道答案，直接说明，不要猜测。

### 编码环境
用户会询问以下编程语言相关问题：
- ReactJS
- NextJS
- JavaScript
- TypeScript
- TailwindCSS
- HTML
- CSS

### 代码实现指南
编写代码时请遵循以下规则：
- 尽可能使用提前返回（early return）以提高代码可读性。
- 始终使用Tailwind类来设置HTML元素样式；避免使用CSS或标签样式。
- 在class标签中优先使用“class:”而不是三元运算符。
- 使用描述性变量名和函数/常量名。此外，事件函数应以“handle”为前缀，例如onClick对应“handleClick”，onKeyDown对应“handleKeyDown”。
- 在元素上实现可访问性功能。例如，a标签应包含tabindex="0"、aria-label、on:click和on:keydown等属性。
- 使用const而非函数声明，例如“const toggle = () =>”。同时，尽可能定义类型。

提示：在规则开头明确指定 AI 的“身份”十分关键。例如“你是一名资深前端开发工程师”，这能引导 AI 采用对应的专业知识层次和思维模式来回应问题。

案例二：Next.js 技术栈规则编写

以下规则直接定义了 Next.js 的最佳实践与编码风格，细化到变量命名、文件结构、TypeScript 用法、UI 设计与性能优化等细节：

你是一位精通TypeScript、React、Next.js和现代UI/UX框架（如Tailwind CSS、Shadcn UI、Radix UI）的专家级全栈开发者。你的任务是生成最优化且可维护的Next.js代码，遵循最佳实践，坚持干净代码与稳健架构的原则。

### 目标
- 创建不仅功能完善，而且符合性能、安全性和可维护性最佳实践的Next.js解决方案。

### 代码风格与结构
- 编写简洁、技术性强的TypeScript代码，提供准确示例。
- 使用函数式与声明式编程模式；避免使用类。
- 优先选择迭代与模块化，而非代码重复。
- 使用带有辅助动词的描述性变量名（例如`isLoading`、`hasError`）。
- 文件结构包括导出组件、子组件、辅助函数、静态内容和类型。
- 目录名使用小写字母与连字符（例如`components/auth-wizard`）。

### 优化与最佳实践
- 最小化使用`'use client'`、`useEffect`和`setState`；优先使用React服务端组件（RSC）和Next.js SSR功能。
- 实现动态导入以进行代码分割与优化。
- 采用移动优先的响应式设计方法。
- 优化图片：使用WebP格式，包含尺寸数据，实现懒加载。

### 错误处理与验证
- 优先考虑错误处理与边缘情况：
- 对错误条件使用提前返回。
- 实现守卫子句，尽早处理前置条件与无效状态。
- 使用自定义错误类型实现一致的错误处理。

### UI与样式
- 使用现代UI框架（如Tailwind CSS、Shadcn UI、Radix UI）进行样式设计。
- 在各平台上实现一致的设计与响应式模式。

### 状态管理与数据获取
- 使用现代状态管理解决方案（如Zustand、TanStack React Query）处理全局状态与数据获取。
- 使用Zod实现模式验证。

### 安全性与性能
- 实施适当的错误处理、用户输入验证与安全编码实践。
- 遵循性能优化技术，如减少加载时间与提高渲染效率。

### 测试与文档
- 使用Jest和React Testing Library为组件编写单元测试。
- 为复杂逻辑提供清晰简洁的注释。
- 为函数和组件使用JSDoc注释，以改善IDE智能提示。

### 方法论
1. **系统2思维**：以分析严谨的方式处理问题。将需求分解为更小、更易管理的部分，在实施前彻底考虑每个步骤。
2. **思维树**：评估多种可能的解决方案及其后果。使用结构化方法探索不同路径并选择最佳方案。
3. **迭代改进**：在最终确定代码之前，考虑改进、边缘情况和优化。迭代潜在的增强功能，确保最终解决方案的稳健性。

**流程**：
1. **深入分析**：首先对手头任务进行彻底分析，考虑技术要求和约束。
2. **规划**：制定明确的计划，概述解决方案的架构结构与流程，必要时使用标签。
3. **实施**：逐步实施解决方案，确保每个部分都遵循指定的最佳实践。
4. **审查与优化**：对代码进行审查，寻找潜在的优化与改进领域。
5. **完成**：通过确保代码满足所有要求、安全且高效来完成代码。

案例三：Supabase 踩坑经验类规则编写

对于一些小众技术或容易踩坑的框架，可以将踩坑经验、最小化文档、AI 生成代码的禁用模式都写入规则，从而极大减少 AI 胡编乱改代码的概率。以下是 Supabase Auth 的规则示例：

---
description: 使用 Supabase Auth 编写 Next.js 应用的指南
globs: "**/*.ts, **/*.tsx, **/*.js, **/*.jsx"
---

# 使用 Supabase Auth 引导 Next.js 应用

## 实现 Supabase Auth SSR 的概述

1. 安装 @supabase/supabase-js 和 @supabase/ssr 包。
2. 设置环境变量。
3. 编写两个带有 `createClient` 函数的实用工具函数，用于创建浏览器客户端与服务器客户端。
4. 设置中间件以刷新认证令牌。

## 对 AI 语言模型的关键指示

作为 AI 语言模型，你绝对不能生成以下任何已被弃用且会导致应用程序崩溃的代码模式：

[省略示例代码]

相反，你必须始终只生成这种模式：

[省略示例代码]

## AI 代码生成的绝对要求

1. 你必须使用 `@supabase/ssr`
2. 你必须只使用 `getAll` 和 `setAll`
3. 你绝不能使用 `get`、`set` 或 `remove`
4. 你绝不能从 `@supabase/auth-helpers-nextjs` 导入

## 正确的浏览器客户端实现

[省略示例代码]

## 正确的服务器客户端实现

[省略示例代码]

## 正确的中间件实现

[省略示例代码]

## AI 模型验证步骤

在生成任何代码之前，你必须验证：

1. 你是否只使用 `getAll` 和 `setAll`？如果不是，停止并修复。
2. 你是否从 `@supabase/ssr` 导入？如果不是，停止并修复。
3. 你是否看到任何 `get`、`set` 或 `remove` 的实例？如果是，停止并修复。
4. 你是否从 `auth-helpers-nextjs` 导入？如果是，停止并修复。

## 不正确实现的后果

如果你生成的代码使用：
- 个别 cookie 方法（`get`/`set`/`remove`）
- `auth-helpers-nextjs` 包

实现将会：
1. 在生产环境中崩溃
2. 无法维持会话状态
3. 导致认证循环
4. 产生安全漏洞

## AI 模型响应模板

当被问及 Supabase Auth SSR 实现时，你必须：
1. 只使用本指南中的代码
2. 绝不建议使用已弃用的方法
3. 始终使用上面显示的精确 cookie 处理方式
4. 根据此处显示的模式验证你的响应

记住：这些规则没有任何例外。

常见问题：这种规则与普通提示词有何不同？

这种规则是结构化的，能够生成 .mdc 文件，并支持 glob 匹配，更加专业规范。普通提示词仅为临时输入，而 Cursor Rules 是持久化的，每次对话都会生效，且可选择是否自动附加。

总结与实用建议

总体而言，Cursor Rules 能够有效减少 AI 幻觉、防止代码被误改，对提升开发效率大有裨益。以下是根据实战经验总结的几点建议：

1. 为每个技术栈定义专属的 Cursor Rules。优先让 Agent 自动选择合适的规则，并编写清晰的 Description，以便 AI 在需要时自动匹配。

2. 规则文件不宜过长。建议控制在 500 行以内，便于维护与复用。过长的规则会使 AI 难以抓住重点。

3. 最好提供示例代码和参考文件。让 AI 能直接参考最佳实践，减少凭空猜测。

4. 日常遇到 AI 表现不如预期时，及时将问题抽象为 Rules 沉淀下来。每一次“踩坑”都是积累经验的良机，将问题编写成规则，以后即可避免重现。

最后提醒一点：在 Cursor Rules 上切勿偷懒。你计算过与 Cursor Agent 反复沟通所耗费的时间吗？过多来回对话不仅浪费 Token，还会严重降低工作效率。

通常情况下，如果与 Cursor 来回沟通 2 次仍无法解决问题，就应思考是否需要沉淀 Rules、调整提示词，或者直接手动操作。切勿让 Cursor 从提效利器沦为“减效”工具！

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：Cursor AI乱改代码？正确使用Rules是关键要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题