如何利用 Cursor 的 Rules 配置文件统一整个项目的代码风格？

把 .cursorrules 扔在项目根目录下，比在 Chat 窗口里一遍遍强调“请使用 TypeScript 严格模式”要高效得多。很多人把这个文件当成简单的 Prompt 库，但其实它更像是一个针对 AI 的「项目级 Lint 配置」。

我之前接手一个多人协作的 Next.js 项目，最头疼的就是 AI 生成的代码风格打架：一会儿用 function 定义组件，一会儿用箭头函数；一会儿用 lucide-react 图标，一会儿又给我引入 heroicons。

解决办法就是把项目的技术栈约束和编码偏好直接写死在 .cursorrules 里。我的配置逻辑是：强制定义路径约定 → 锁定组件库写法 → 规定错误处理模式。

这是我目前在生产环境中使用的一套配置片段，大家可以直接参考：

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

# Coding Standards
- Use arrow functions for all components.
- Use 'lucide-react' for icons; do not use any other icon libraries.
- All components must be placed in @/components/ui or @/components/features.
- Use Zod for all API response validation.

# Naming Convention
- Components: PascalCase (e.g., UserProfile.tsx)
- Hooks: camelCase starting with 'use' (e.g., useAuth.ts)
- Utility functions: camelCase (e.g., formatDate.ts)

# Error Handling
- Wrap all async server actions in a try-catch block.
- Use a custom 'handleError' utility for logging instead of console.log.

几个实战踩坑点和优化技巧：

避免过度约束。 不要在这个文件里写“代码要简洁”这种废话，AI 对模糊词汇的理解不稳定。要写“禁止在组件内直接编写超过 10 行的逻辑，必须抽离到 custom hook 中”，这种有量化标准的指令才有效。

配合 .cursorignore 使用。 如果项目里有巨大的 dist 文件夹或第三方库源码，一定要在 .cursorignore 里排除掉，否则 Cursor 在索引项目上下文时会浪费大量的 Token，导致生成的代码出现幻觉，甚至开始参考过时的依赖版本。

动态更新规则。 我习惯在开发过程中，一旦发现 AI 连续两次在同一个地方犯错（比如忘了给图片加 alt 属性），就立刻把这个要求加进 .cursorrules。这样下次它在整个项目的任何文件中写图片标签时，都会自动补全。

这样配置后，不管是使用 Cmd+K 修改局部代码，还是用 Composer 批量生成新功能，出来的代码风格几乎能和我的手写代码保持 90% 的一致，省去了大量手动调整格式的时间。