一次面试让我重新认识了 Cursor

上周面试的时候，面试官突然问我："你用过 Cursor 对吧，那你知道 rules 嘛？"

当时小爱一愣，把问题听成了Cursor的弱势，本来一张嘴就要编了，结果被面试官及时制止，强行纠正了下发音

没事，不明白咱可以学。面试完了，小爱同学就去了解了下这个点

什么是 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用中文回复我们

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示例

markdown 复制代码

# 项目背景
这是一个在线旅游攻略分享平台，前端使用 React + TypeScript + TailwindCSS，
后端提供 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 让系统自动生成规则