上周面试的时候,面试官突然问我:“你用过 Cursor 对吧,那你知道 rules 嘛?”
当时小爱一愣,把问题听成了 Cursor 的弱势,本来一张嘴就要编了,结果被面试官及时制止,强行纠正了下发音
没事,不清楚咱可以学。面试完了,小爱同学就去了解了下这个点
C 什么是 Cursor Rules
Cursor Rules 也就是 Cursor 规则 ,本质上就是一组“ 开发规范/约束提示 ”,告知 AI 在帮你写代码、生成文件时要遵守的规则。类似于你在写 prompt,但它是持久的,全局生效
Cursor Rules 有两种类型:全局规则 (User Rules)、项目规则 (Project Rules),全局适用于所有项目,项目则只对指定的生效
为什么需要它
#技术分享在日常开发里,你可能遇到过这些问题:
- 代码风格不一致(缩进、命名、注释习惯)
- 技术栈有约束(项目规定只能用 React18,结果 AI 给你写了 React19 新语法)
- 项目结构固定(组件必须放在 /components 目录,API 请求要放到 api.ts ,但 AI 一不小心就写到别的地方)
- 安全或团队规范(敏感信息不能出目前代码里,要遵守 ESLint 规则)
如果没有规则,AI 可能会:
- 给你生成团队不接受的写法
- 写出跑不通或风格不统一的代码,需要手动去修改
- 推荐你不允许的依赖或库
有了 Rules,就能在 源头上 减少这些麻烦
怎么使用
- 打开一个项目
- 点击右上角的设置 ⚙️
- 选择 Rules & Memories
- 在 User Rules 里添加全局规则,或者在 Project Rules 里为单个项目配置
User rules
在 Cursor Settings 的面板中可以直接配置,这边一般是设置 Cursor 用中文回复我们
C Project rules
Cursor 会在项目根目录下生成一个 .cursor 文件夹,我们需要在这个文件夹下的 rules 文件夹中新建一个包含 rules 的配置文件,内容格式为 Mardown 语法
目前包含 四种 应用方式
| 模式 | 含义 | 触发方式 | 使用场景 | | —
| always | 始终生效 | 无论什么情况都会应用 | 列如:所有代码都必须用 TypeScript,不允许 any | | auto attached | 自动附加 | Cursor 在检测到相关上下文时自动加载 | 列如:打开 api/ 目录下的文件,就自动应用“必须用 fetch”规则 | | agent requested | 智能体请求时附加 | 当 AI Agent(助手)判断需要用到某个规则时才应用 | 列如:AI 在写 React 代码时才会附加 “用函数组件,不要 class 组件” | | manual | 手动启用 | 需要用户在规则面板里手动点选 | 列如:某些临时实验性规则,默认不启用,偶尔才开 |
编写一个项目的 rules 主要有以下几方面需要注意:
- 提供项目背景
- 编码标准
- 约束首选库和框架
- 提供清晰的文件结构信息
- 文档规范
以下是一个 rules 示例
# 项目背景
这是一个在线旅游攻略分享平台,前端使用 React +
后端提供 RESTful API。目标是让用户能快速分享和浏览旅游日记。
# 编码标准
- 所有代码必须使用 TypeScript,不允许使用 JavaScript。
- 变量命名统一使用 camelCase。
- React 组件必须使用 PascalCase。
- 自定义 Hooks 必须以 `use` 开头。
# 库和框架约束
- 必须使用 React 18,不要用 React 19 新特性。
- 样式必须使用 TailwindCSS,不要写内联 style。
- 网络请求必须使用 `fetch`,不允许用 axios。
# 文件结构
- 业务组件放在 `src/components` 下。
- API 调用必须封装在 `src/api` 下。
- 所有页面文件放在 `src/pages` 下。
- 公共工具函数放在 `src/utils` 下。
# 文档规范
- 导出的 API 方法必须写 JSDoc 注释。
- 复杂逻辑的 Hooks 必须写注释,说明参数和返回值。
- 每个页面组件文件顶部必须有模块说明注释。
# 安全规范
- 不要把明文 API Key、token 写在代码里。
- 所有配置从 `.env` 里读取,通过 `process.env` 使用。
另外可以参考 awesome-cursorrules ,当然还可以输入 /Generate Cursor Rules 让系统 自动生成规则


