如何在 Cursor 中通过 .cursorrules 深度自定义 AI 的代码生成风格

很多人把 .cursorrules 当成简单的说明书，其实它更像是给 AI 注入的“性格补丁”和“工程标准”。如果你不配置它，Cursor 生成的代码虽然能跑，但往往充满了冗余的注释，或者在明明有更优雅的 API 时非要用最基础的写法。

我目前的配置核心逻辑是：强制约束 + 风格定义 + 避坑指南。

在项目根目录下创建 .cursorrules，我最依赖的是以下这几段配置：

1. 强制技术栈对齐（防止 AI 乱用库）
为了避免 AI 在写 React 时一会儿用 useEffect 一会儿用 React Query，我会明确规定：

- Use Tailwind CSS for all styling, no CSS-in-JS.
- Use Zod for schema validation.
- For state management, strictly use Zustand; avoid Redux.
- Use TypeScript 'strict' mode, no 'any' type allowed.

2. 定义代码“审美”（减少冗余）
我最烦 AI 在每个函数上面写 // This function does X 这种废话，我会直接在规则里写：

- Avoid obvious comments. Only explain 'Why', not 'What'.
- Prefer functional programming patterns (map, filter, reduce) over for-loops.
- Use early returns to reduce nesting depth.
- All components must be defined as arrow functions.

3. 针对特定项目的“避坑指南”
这是最实用的一点。比如我的项目里某个第三方 SDK 的文档比较陈旧，AI 经常写错 API，我就直接把正确用法写死在规则里：

- When using the 'X-Payment-SDK', always call .init() before .process(), otherwise it throws a 401 error.
- The project's API base URL is managed via env variable VITE_API_BASE, never hardcode URLs.

实际提升的效率点：
配置完这些后，我发现 Cmd+K 生成代码的“二次修改率”降低了至少 40%。以前生成一个组件，我得手动删掉一堆没用的注释，再把 function 改成 const；现在它出来的直接就是我想要的风格，直接 Accept 即可。

踩过的坑：
不要把 .cursorrules 写得太臃肿（超过 2000 字）。如果规则过多，AI 在处理复杂逻辑时会因为 Token 压力而忽略部分指令，甚至出现“顾此失彼”的情况。建议按【全局通用规则】 → 【技术栈约束】 → 【项目特有陷阱】这个优先级来组织内容。

如果需要针对不同模块切换规则，目前 Cursor 还不支持子目录规则，我的折中方案是在不同功能的文件夹里放个 README.md，在 Prompt 里提醒它 Refer to the local README for specific logic。