你是不是也遇到过这种情况:Cursor 生成的代码想法不错,但总有些小毛病?比如用了过时的库、不符合团队的命名习惯,或者放错了文件位置?每次都要手动调整,也挺费时间。
Cursor 的用户规则(Rules)功能,就是用来解决这些痛点的。 简单说,它就是一套你给 Cursor 定制的“说明书”,告诉它你的项目里哪些能做,哪些不能做,应该怎么做。配置好后,AI 生成代码的“命中率”会大大提高。
用户规则
项目上下文缺失? -> 规则告诉它:我们用的是 React + TypeScript ,文件结构是 /src/components/ 放组件。
代码风格混乱? -> 规则明确要求:函数名用 camelCase,组件名用 PascalCase,常量全大写 UPPER_CASE。
每次都重复要求? -> 规则一次性写好:“所有组件必须是函数式”、“禁止使用 any 类型”。
AI 生成的代码更贴合你的项目,省去大量修改时间
动手配置
新版规则(v0.45+)更清晰、更模块化,配置起来很简单:
- 创建规则文件夹:
- 在项目的根目录下,创建文件夹:.cursor/rules这个文件夹专门存放你的规则文件。
- 在 .cursor/rules 里,新建一个以 .mdc 结尾的文件(比如 frontend-rules.mdc)。文件内容结构如下(非常清晰):
### Description这里写规则是干嘛的,比如:“定义前端React组件规范”### Globs这里写规则对哪些文件生效,比如:`*.tsx` (只对 TypeScript React 文件生效) 或 `src/components/**/*.js` (指定目录下的JS文件)### Content这里是具体的规则要求,用 Markdown 列表写清楚:- 必须用函数式组件- CSS:只用 Tailwind CSS 工具类- 禁止使用 `any` 类型,必须明确类型- 组件文件放在 `/src/components/ui/`
保存 .mdc 文件后,Cursor 会自动加载这条规则,不需要重启!下次它生成或修改代码时,就会遵守这些要求了。
别一开始就想写本“百科全书”。
先解决最痛的1-3个问题(比如命名混乱、any泛滥、文件乱放)。
规则太多太长,反而可能影响AI的理解和性能。保持核心规则(10条以内是个不错的起点),后续再慢慢补充。当然也可以让 AI 帮你生成规则,直接在 Chat 中输入:
比如请写一条规则:禁止在 JavaScript 中使用空值合并操作符(??),改用逻辑或(||)
复制生成的规则到 .mdc 文件即可永久生效。
总结
Cursor 的用户规则,本质是把你和团队的最佳实践、踩过的坑,固化成给AI的明确指令。它不是限制AI,而是让它在你项目的轨道上跑得更快更稳。你会发现,一点点规则的投入,就能让AI编程助手变得真正“懂你”。今晚就试试吧!