如何在 Cursor 中通过配置 .cursorrules 让 AI 严格遵守项目编码规范

项目规模一旦超过 10 个文件，Cursor 的 AI 就开始变得“随缘”，经常出现明明定义了全局状态管理却非要写个本地 State，或者在 TypeScript 项目里写出 any 这种低级错误。要解决这个问题，不能靠每次对话重复叮嘱，得把规范写死在 .cursorrules 里。

这个文件的优先级极高，它相当于给 AI 注入了一套“项目宪法”，AI 在生成每行代码前都会先扫描一遍。

我的配置逻辑是：约束 > 偏好 > 示例。不要写“请尽量使用”，要写“必须使用”或“严禁使用”。

这里分享一套我目前在 React + Tailwind 项目中稳定运行的配置片段：

# Project Coding Standards

**Tech Stack**
- Framework: Next.js 14 (App Router)
- Styling: Tailwind CSS
- State Management: Zustand

**Strict Rules**
- 严禁使用 `any` 类型，必须定义具体的 Interface 或 Type。
- 所有组件必须使用箭头函数定义，禁止使用 `function` 关键字。
- 样式必须使用 Tailwind 原子类，禁止在 .css 文件中写自定义样式，除非是全局变量。
- 异步请求必须包裹在 try-catch 块中，并调用 `toast.error()` 处理异常。

**Naming Convention**
- 组件文件：大驼峰 (PascalCase)，如 `UserCard.tsx`
- 钩子函数：以 use 开头，如 `useAuth.ts`
- 变量/函数：小驼峰 (camelCase)

**Code Example**
Correct: 
const UserProfile = () => { ... }
Incorrect: 
function UserProfile() { ... }

配置技巧上，建议将 .cursorrules 放在项目根目录。如果项目很大，我会把这个文件拆分成“全局规范”和“模块规范”。比如在 /src/components 目录下再放一个特定的规则文件，强制 AI 在写组件时必须包含 loading 状态的 UI 处理。

踩过的一个大坑是：规则写得太冗长会导致 AI 丢失上下文。如果你把整个 API 文档都塞进去，它可能会在写简单逻辑时变得迟钝。最好的做法是只写判断标准，具体的 API 细节通过 @Docs 引用。

效率提升最明显的地方在于：以前我得手动修改 AI 生成的 5 处命名错误，现在它直接输出符合规范的代码，我只需要按 Tab 键确认，整个 Review 环节缩短了 70%。