目录
- 前言
- [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.tsMDC 元数据的作用如下：
| 字段 | 功能 |
|---|---|
| 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_case3.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.tsservice/user.service.tscontroller/user.controller.ts- snake_case 数据库字段
- TypeScript 类型
规范全自动执行，无需重复说明。
8. 总结
Cursor 的规则体系为 AI 编程提供了极强的可控性和持续性。它让模型在每次补全之前自动掌握项目背景、风格规范和组织标准，从而显著提升开发效率和一致性。
从个人开发者到大型企业团队，规则系统都能让 AI 以一种更"专业"、"可控"的方式参与到工程流程中。掌握规则的结构、优先级与应用方法，将帮助团队真正把 AI 打造成生产级工具，而不仅仅是辅助写代码的"小帮手"。
参考资料
- Cursor 官方文档：Rules & Settings
- Cursor Team Console Guide