深入理解 Cursor 规则体系

前言
[1. Cursor 规则体系概览](#1. Cursor 规则体系概览)
- [1.1 规则的核心价值](#1.1 规则的核心价值)
- [1.2 四种规则类型总览](#1.2 四种规则类型总览)
[2. 项目规则（Project Rules）](#2. 项目规则（Project Rules）)
- [2.1 项目规则的工作方式](#2.1 项目规则的工作方式)
- [2.2 MDC 结构解析](#2.2 MDC 结构解析)
- [2.3 规则类型说明](#2.3 规则类型说明)
- [2.4 嵌套规则：层级化管理大型项目](#2.4 嵌套规则：层级化管理大型项目)
[3. AGENTS.md：轻量的规则替代方案](#3. AGENTS.md：轻量的规则替代方案)
- [3.1 定位与适用场景](#3.1 定位与适用场景)
- [3.2 支持嵌套](#3.2 支持嵌套)
[4. 用户规则（User Rules）](#4. 用户规则（User Rules）)
- [4.1 用户规则的定位](#4.1 用户规则的定位)
- [4.2 优先级](#4.2 优先级)
[5. 团队规则（Team Rules）](#5. 团队规则（Team Rules）)
- [5.1 团队规则的优势](#5.1 团队规则的优势)
- [5.2 启用与强制策略](#5.2 启用与强制策略)
- [5.3 注意：不支持 MDC](#5.3 注意：不支持 MDC)
[6. 规则最佳实践](#6. 规则最佳实践)
- [6.1 写好规则的原则](#6.1 写好规则的原则)
- [6.2 示例：前端+后端规范统一模板](#6.2 示例：前端+后端规范统一模板)
- [6.3 自动化开发场景示例](#6.3 自动化开发场景示例)
[7. 项目应用示例：结合架构与规则的实践](#7. 项目应用示例：结合架构与规则的实践)
- [7.1 架构风格示例](#7.1 架构风格示例)
- [7.2 示例场景：AI 自动生成服务代码](#7.2 示例场景：AI 自动生成服务代码)
[8. 总结](#8. 总结)
参考资料

前言

随着基于 AI 的智能开发工具不断涌现，Cursor 正逐渐成为新一代工程师的强力助手。它不仅能生成代码，更能在项目结构、风格约束和团队协作中提供持续一致的智能辅助。为了让 AI 在每次补全中保持稳定的上下文与规则意识，Cursor 引入了 规则系统（Rules System） ------ 一个可持续、可配置、可协作的模型提示层机制。

本篇文章将从规则的分类、结构、应用方式到团队实践，系统解析 Cursor 规则体系的完整逻辑，并给出架构设计建议、组织管理方式、示例场景与最佳实践。

1. Cursor 规则体系概览

1.1 规则的核心价值

大型语言模型在会话之间不会记忆任何上下文，而开发过程又需要大量重复性的风格约束、业务知识、架构理念。如果一遍遍手动输入，不仅效率低，还容易因表达差异导致结果不一致。

Cursor 的规则系统解决了这一问题：
通过结构化规则，让 AI 在每次生成结果前自动加载统一的、持久的上下文。

规则的作用包括但不限于：

固化团队编码规范
自动注入架构模式、业务逻辑限制
让 AI 了解你的代码库、风格、模板
统一整个团队的 AI 开发体验
避免每次对话重复说明背景

Cursor 提供四类规则，覆盖从个人到组织的全层级场景。

1.2 四种规则类型总览

类型	存储位置	作用范围	控制方式	元数据支持	优先级
项目规则（Project Rules）	`.cursor/rules`	当前项目	文件级	支持 MDC	中
用户规则（User Rules）	Cursor Settings	个人全局	配置界面	不支持元数据	低
团队规则（Team Rules）	Cursor Console	全团队	强制/启用控制	不支持元数据	最高
AGENTS.md	项目根目录	当前项目	文件级	无元数据	中偏低

2. 项目规则（Project Rules）

2.1 项目规则的工作方式

项目级规则位于 .cursor/rules/ 目录，每个规则对应一个单独的 .mdc 文件。Cursor 会根据文件元数据（如 globs、alwaysApply）决定何时加载它。

所有项目规则均可进入 Git 版本管理，意味着：

规则随仓库共享
团队开发时一致性强
可随着分支演进进行版本管理

2.2 MDC 结构解析

一个典型规则文件如下：

md 复制代码

---
globs:
  - backend/**/*.ts
alwaysApply: false
description: 使用服务模板并遵循内部 RPC 模式
---

- 定义服务时使用内部 RPC 模式
- 服务名称始终使用 snake_case 命名
@service-template.ts

MDC 元数据的作用如下：

字段	功能
globs	仅在匹配文件相关时激活
alwaysApply	强制对所有聊天加载
description	让 Cursor 知道该规则用于什么场景

2.3 规则类型说明

Cursor 提供四种应用方式：

Always Apply（全局生效）
Apply Intelligently（智能触发）
Apply to Specific Files（按文件触发）
Apply Manually（手动 @ 激活）

项目规则的灵活性决定了它能覆盖大部分工程需求。

2.4 嵌套规则：层级化管理大型项目

Cursor 支持目录级 .cursor/rules：

复制代码

project/
  .cursor/rules/
  backend/
    server/
      .cursor/rules/
  frontend/
    .cursor/rules/

文件所在目录越深，越会优先加载该目录的规则。这使得：

后端与前端可用不同规范
某些模块可使用自定义架构
大型 monorepo 项目更容易管理

3. AGENTS.md：轻量的规则替代方案

3.1 定位与适用场景

AGENTS.md 是一个位于项目根目录的轻量规则文件，没有元数据，也不支持 globs。它非常适合：

小型项目
简单指令
临时规范
不需要复杂触发机制的团队

例如：

复制代码

# AGENTS.md
- 所有新文件使用 TypeScript
- React 组件全部使用函数式组件
- 数据库列名必须使用 snake_case

3.2 支持嵌套

与项目规则类似，AGENTS.md 可在子目录中存在，用于覆盖更具体的规范。

4. 用户规则（User Rules）

4.1 用户规则的定位

位置：Cursor Settings → Rules

范围：作用于所有项目

适合用于：

对话偏好（如"请简洁回复"）
个人编码风格
通用习惯

例如：

复制代码

请保持回答简洁，不要重复上下文。

4.2 优先级

用户规则的优先级 低于项目规则与团队规则。如两者冲突，优先遵循上级规则。

这确保团队规范优先于个人习惯。

5. 团队规则（Team Rules）

5.1 团队规则的优势

Team 和 Enterprise 套餐可以使用团队规则，集中管理全组织的 AI 规范。团队规则具有最高优先级，并提供强制执行能力。

适合用于：

统一编码规范
落实跨项目通用架构
安全与合规要求
组织级最佳实践

5.2 启用与强制策略

团队规则有两个控制开关：

开关	含义
立即启用	启用后所有成员自动生效
强制执行	成员不可关闭该规则

这让管理员能确保规则严格落地。

5.3 注意：不支持 MDC

团队规则是纯文本，没有 globs、描述字段、alwaysApply 等特性。

6. 规则最佳实践

6.1 写好规则的原则

以下是文章中唯一一次使用无序列表：

聚焦单一主题，避免"一条规则做所有事"
规则内容不宜超过 500 行
提供示例、路径、模板引用
用明确的行动指令而不是模糊表达
拆成多个可组合的规则文件
尽量采用项目规则以便版本管理

6.2 示例：前端+后端规范统一模板

代码风格表（示例）：

内容	规范
新文件	TypeScript
React	函数组件优先
服务层	Repository 模式
数据库	snake_case
业务逻辑	统一放在 service 层

6.3 自动化开发场景示例

Cursor 规则非常适合封装常用场景：

生成 Express 服务模板
生成 React 组件标准结构
自动验证前后端 API
自动输出文档骨架

一个成熟团队甚至可以将内部所有脚手架流程自动化到规则中。

7. 项目应用示例：结合架构与规则的实践

7.1 架构风格示例

假设项目采用如下架构：

TypeScript 全栈
Repository 模式
服务层承载业务逻辑
数据层隔离 ORM

你可以通过规则让 AI 自动遵从该架构，从而避免新人和外包写出不一致的代码。

7.2 示例场景：AI 自动生成服务代码

只需一句话：

复制代码

创建一个 user 服务，包含基础 CRUD 和业务校验。

AI 会按照规则自动生成：

repository/user.repository.ts
service/user.service.ts
controller/user.controller.ts
snake_case 数据库字段
TypeScript 类型

规范全自动执行，无需重复说明。

8. 总结

Cursor 的规则体系为 AI 编程提供了极强的可控性和持续性。它让模型在每次补全之前自动掌握项目背景、风格规范和组织标准，从而显著提升开发效率和一致性。

从个人开发者到大型企业团队，规则系统都能让 AI 以一种更"专业"、"可控"的方式参与到工程流程中。掌握规则的结构、优先级与应用方法，将帮助团队真正把 AI 打造成生产级工具，而不仅仅是辅助写代码的"小帮手"。

参考资料

Cursor 官方文档：Rules & Settings
Cursor Team Console Guide