工具与定位
Cursor Rules 是 Cursor IDE 的上下文注入系统，通过 .cursorrules 文件告诉 AI 项目的编码规范、架构模式和约束条件。正确配置后，AI 补全和建议会更贴合项目实际，减少无效输出。
规则类型
| 类型 | 说明 | 示例 |
|---|---|---|
| 项目概览 | 项目定位、技术栈、核心模块 | ”这是 Vue 3 + TypeScript 项目，使用 Pinia 状态管理” |
| 编码规范 | 命名、格式、注释约定 | ”组件使用 PascalCase，工具函数使用 camelCase” |
| 架构约束 | 目录结构、依赖规则、禁止项 | ”禁止在组件层直接调用 API，必须通过 Store” |
| 测试要求 | 测试框架、覆盖率、命名 | ”使用 Vitest，测试文件与源码同目录，*.test.ts” |
| 技术栈细节 | 版本、配置、特有模式 | ”UnoCSS 替代 Tailwind，自定义 shortcuts 在 uno.config.ts” |
配置方式
| 方式 | 说明 |
|---|---|
| .cursorrules | 项目根目录，全局规则 |
| .cursor/rules/*.mdc | 多文件规则，按场景拆分 |
| Settings | Cursor 设置界面，全局默认规则 |
平台接入
| 平台 | 说明 |
|---|---|
| Cursor Rules | 官方文档 |
| Cursor Directory | 社区规则模板库 |
| Awesome .cursorrules | GitHub 精选集合 |
选型建议
新项目先用通用模板快速启动；成熟项目逐步细化规则；团队统一用私有规则库；多技术栈用多文件 .mdc 规则。