如何利用 Cursor 的 Rules 配置文件快速统一项目代码风格?
.cursorrules 文件其实就是给 Cursor 注入的“项目级灵魂”,如果你还在通过对话框一遍遍告诉它“请使用 TypeScript 严格模式”或者“不要写注释”,那效率太低了。我最近在接手一个混乱的 Next.js 遗留项目,团队里有人习惯用 Arrow Function,有人习惯用 function 关键字,导致 Git Diff 极其难看。我直接在根目录建了一个 .cursorrules,把所有风格约束强行拍在 AI 的上下文里。
我的配置核心逻辑是:禁止模糊指令,给具体示例。
不要写“代码要简洁”,要写“优先使用三元运算符代替简单的 if-else”。以下是我目前最有效的一套配置片段:
# 编码标准
- 状态管理:统一使用 Zustand,禁止在组件内滥用 useState 传递深层 Props。
- 命名规范:组件文件采用 PascalCase,Hooks 必须以 use 开头。
- 样式方案:强制使用 Tailwind CSS,禁止写内联 style 或单独的 .css 文件。
# 避坑指南
- 严禁使用 any,必须定义 Interface 或 Type。
- 在编写 API 路由时,必须包裹在 try-catch 中并返回统一的 { data, error } 格式。
# 示例参考
- 好的写法:const UserProfile = () => { ... }
- 坏的写法:function UserProfile() { ... }实际操作中的几个关键技巧:
1. 结合 .cursorrules 与 Composer 模式
当你开启 Ctrl+I (Composer) 进行大规模重构时,Cursor 会优先读取这个配置文件。我试过在规则里加入 Whenever you modify a component, ensure it follows the Atomic Design pattern,它在生成新文件时会自动把组件分到 /components/atoms 或 /components/molecules,省去了我手动搬运文件的麻烦。
2. 动态更新规则
最有效的用法是:当你发现 AI 连续两次在同一个地方犯错(比如它总是忘记在 useEffect 里加依赖项),不要只在对话里纠正它,直接把这个教训写进 .cursorrules。
踩过的坑:
规则不要写得太冗长。如果配置文件超过 200 行,AI 有时会出现“注意力漂移”,反而忽略掉中间的指令。建议将规则分为 【强制约束】 和 【倾向习惯】 两部分,优先级最高的放最前面。
通过这套配置,我现在在项目里生成新模块的“二次修改率”降低了大概 40%,基本实现了从生成到提交只需简单 Review 即可。
全部回复 (0)
还没有回复,来发第一条吧!
