摘要：在 AI 编程时代，如何让助手精准理解您的项目规范？当团队协作时，如何确保每位开发者生成的代码风格统一？Cursor Rules 正是您需要的终极解决方案——它如同一位永不疲倦的架构师，通过预设规则控制 AI 的每一次代码生成、重构与补全行为。
在 AI 编程时代，如何让助手精准理解您的项目规范？当团队协作时，如何确保每位开发者生成的代码风格统一？Cursor Rules 正是您需要的终极解决方案——它如同一位永不疲倦的架构师，通过预设规则控制 AI 的每一次代码生成、重构与补全行为。
本教程将带您深入 Cursor Rules 的三大核心战场：
🔹 规范控制：锁定代码风格、命名规则与技术栈
🔹 智能约束：自动拒绝危险操作，守护核心逻辑
🔹 团队协同：让 AI 成为项目规范的强力执行者
无论您是独立开发者期望提升效率，还是技术负责人需要统一团队产出，只需 15 分钟，即可让 AI 彻底臣服于您的技术意志。
现在启程 ▶ 解锁以下能力：
✓ 零成本复刻大厂代码规范 ✓ 自动拦截“瞎写”的 AI 代码
✓ 一键生成企业级项目模板 ✓ 解决 AI 生成代码的“最后一公里”问题
一、Cursor Rules 核心概念
作用原理
Cursor Rules 是持久化指令，通过预定义规则约束 AI 生成的代码风格、技术栈和项目规范。规则内容会被插入到模型上下文开头，确保每次交互的一致性。
用户规则（User Rules）：全局生效，适用于所有项目（配置路径：Settings > Rules > User Rules）。
项目规则（Project Rules）：存储在项目目录 .cursor/rules/*.mdc，仅限当前项目（官方推荐）。
适用场景：代码补全、重构、错误修复、文档生成等。
规则级别：
规则类型
类型触发条件适用场景Always始终生效通用规范（如代码风格）Auto Attached匹配文件后缀时生效语言/框架规范（如 *.py）Agent RequestedAI 自主判断是否调用复杂决策（如重构逻辑）Manual通过 @规则名 显式调用临时需求
二、配置步骤（以项目规则为例）
创建规则文件
方法 1：图形界面
File → Preferences → Cursor Settings → Rules → Add New Rule
方法 2：快捷键
Cmd/Ctrl + Shift + P → 输入 New Cursor Rule
文件路径：.cursor/rules/规则名.mdc
编写规则内容
规则文件采用 Markdown + YAML 元数据 格式：
三、典型规则示例与使用场景
场景 1：统一代码风格
markdownmarkdown复制# general.mdc（通用规则）---glob: ["*"] # 所有文件生效alwaysApply: true---## 全局规范- 变量命名：`camelCase`- 缩进：2个空格- 注释：复杂逻辑需添加行内说明- 错误处理：异步操作必须用 `try/catch`场景 2：框架规范（React + TypeScript）
markdownmarkdown复制# react.mdc---globs: ["*.tsx"]autoAttach: true---## React 规范- 使用函数组件 + Hooks- 禁止类组件- Props 必须定义接口类型- 样式使用 Tailwind CSS@file ../tailwind.config.js # 引入配置文件场景 3：自动生成模板
markdownmarkdown复制# express-template.mdc---description: Express 服务模板manual: true # 手动调用---## Express 服务规则1. 遵循 RESTful 设计2. 包含错误处理中间件3. 日志使用 `winston`4. 示例代码：```typescriptimport express from 'express';const app = express;// 错误处理中间件app.use((err, req, res, next) => { ... });四、最佳实践与技巧
规则设计原则
模块化拆分：按功能分层（通用 → 语言 → 框架）
示例目录结构：
引用外部文件：用 @file 引入配置文件（如 tsconfig.json）
控制长度：单文件 ≤500 行，避免信息过载。
高级功能
自动生成规则：在聊天框输入 /Generate Cursor Rules，AI 自动分析项目生成规则草稿（需已有代码基础）。
嵌套规则：子目录可放置专属规则（如 backend/.cursor/rules 仅影响后端代码）。
团队协作
将 .cursor/rules 加入 Git 版本控制，确保规则同步。
在 User Rules 中统一团队角色定义：
markdownmarkdown复制# User Rules（全局）你是一名全栈工程师，精通 TypeScript 和 Python。 代码需符合 SOLID 原则，优先复用现有模块。 所有回复用中文。五、常见问题解决
规则未生效：检查文件路径是否在 .cursor/rules 下，或重启 Cursor 加载配置。
AI 仍乱改代码：
增加保护规则：protected: src/core/**/*.js（禁止修改核心文件）
使用 Auto Attached 替代 Always 减少冲突。
💎 总结：Cursor Rules 的核心价值在于 将人工经验转化为 AI 可执行的规范。通过分层设计（通用→语言→框架）+ 引用机制（@file），可显著提升生成代码的可用性，减少反复修改成本。建议从简单规则开始，逐步迭代至复杂场景。
来源：甜甜圈科技
