一次面试让我重新认识了 Cursor – 今日头条

上周面试的时候，面试官突然问我：“你用过 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 主要有以下几方面需要注意：

1. 提供项目背景
2. 编码标准
3. 约束首选库和框架
4. 提供清晰的文件结构信息
5. 文档规范

以下是一个 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 让系统 自动生成规则