Cursor 的 .cursorrules 终极配置指南：写出让 AI 秒懂项目的规则文件

分类：前端工具 | 标签：Cursor、cursorrules、AI编程、前端开发、效率提升

作为前端工程师，用好 Cursor 能显著提升开发效率。而 .cursorrules（以及新版 .cursor/rules/）就是让 AI 真正「懂」你项目的关键。本文从概念、语法、到 Vue3/React/小程序等不同技术栈的配置，再到 3 套可直接复制的完整模板，帮你写出最适合前端的 Cursor 规则。

一、.cursorrules 是什么？

.cursorrules 是 Cursor 编辑器的项目级配置文件，用于向 AI 提供持久化的上下文和约束。它相当于你和 AI 之间的「项目说明书」：框架选型、目录结构、编码规范、常用库等，都可以写进去，避免每次对话都要重复说明。

核心价值：

• 减少重复提示，提高对话效率
• 统一 AI 输出风格，贴近团队规范
• 支持按文件类型应用不同规则（新版 .cursor/rules/）

二、语法与结构

2.1 传统 .cursorrules（单文件）

放在项目根目录，纯文本或 Markdown 格式，无特殊语法：

# 项目规则 - 使用 Vue 3 Composition API - 组件使用 <script setup> - 样式使用 SCSS 

2.2 新版 .cursor/rules/（推荐）

Cursor 现已支持 .cursor/rules/