🚀 一键安装，一键配置！ 为 Cursor AI 快速添加编程规则的 VSCode/Cursor 扩展。提供前端、后端、游戏研发、原生开发、测试等 65 种精选规则模板。
GitHub 地址： https://github.com/snake-mustang/ht-cursor-rules
⭐️ 请不要吝啬你的 STAR，点点 STAR，这对我很重要！
如果这个插件对您有帮助，请到 GitHub 给个 Star ⭐️，这是对我最大的鼓励和支持！
如果您需要的技术栈规则不在列表中，请提交 Issue！我们会尽快添加您需要的规则，帮助团队提升开发效率。
1️⃣ 安装插件：在扩展市场搜索 HT Cursor Rules → 点击安装
2️⃣ 打开命令：按 Ctrl+Shift+P (Mac: Cmd+Shift+P) → 输入 HT
3️⃣ 选择规则：选择技术类别 → 选择具体规则 → 选择添加方式（覆盖/合并）→ ✅ 完成！
🌐 Web 全栈开发：React/Vue/Angular/Svelte + Next.js/Nuxt + FastAPI/Django/NestJS
📱 移动应用开发：SwiftUI/UIKit (iOS) + Jetpack Compose (Android) + React Native/Flutter (跨平台)
🎮 游戏开发：Unity (C#) + Unreal (C++) + Cocos Creator/LayaBox (TypeScript)
🏢 企业级应用：SpringBoot (Java) + Go + Elixir/Phoenix + Laravel (PHP) + NestJS (TypeScript)
方式1（推荐）：在 Cursor/VSCode 中按 Ctrl+Shift+X → 搜索 HT Cursor Rules → 点击安装
方式2：访问 Visual Studio Marketplace 安装
.cursorrules 是 Cursor AI 的强大功能，允许开发者为项目定义专属的 AI 指令。
核心优势：
- ✨ 定制 AI 行为：根据项目需求定制 AI 响应，确保代码建议更相关、更准确
- 📏 保持一致性：定义编码标准和最佳实践，确保 AI 生成符合项目风格的代码
- 🎯 上下文感知：为 AI 提供项目重要上下文（常用方法、架构决策、特定库）
- ⚡ 提高生产力：精准的规则让 AI 生成的代码更少需要手动编辑，加速开发流程
- 👥 团队协作：共享
.cursorrules文件确保团队成员获得一致的 AI 辅助
通过在项目根目录创建 .cursorrules 文件，您可以充分利用这些优势，提升 Cursor AI 编码体验。
🎨 前端框架 (18种) - Angular, React, Vue, Svelte, Solid.js, Qwik, Astro
| 规则 | 说明 |
|---|---|
| 前端通用规则（推荐）⭐ | 适用于所有前端项目的通用开发规范 |
| Angular + TypeScript | Angular TypeScript 开发最佳实践 |
| Astro + TypeScript | Astro TypeScript 开发最佳实践 |
| Next.js 15 + React 19 + Vercel AI | 最新版Next.js + React + Vercel AI SDK |
| Next.js 14 + Tailwind + SEO | Next.js 14 + Tailwind + SEO 优化 |
| Next.js + React + Tailwind | Next.js + React + Tailwind 开发指南 |
| Next.js + React + TypeScript | Next.js + React + TypeScript 开发指南 |
| Next.js + TypeScript | Next.js TypeScript 开发最佳实践 |
| Qwik + TypeScript + Vite | Qwik + TypeScript + Vite 开发指南 |
| React Components | React 组件开发最佳实践 |
| React + TypeScript + Next.js + Node.js | 全栈开发指南 |
| Solid.js Basic | Solid.js 基础开发指南 |
| Solid.js + TypeScript | Solid.js TypeScript 开发指南 |
| Svelte 5 vs Svelte 4 | Svelte 5 vs 4 对比指南 |
| SvelteKit + RESTful API + Tailwind | SvelteKit 完整开发指南 |
| SvelteKit + Tailwind + TypeScript | SvelteKit 开发最佳实践 |
| Vue 3 Composition API | Vue 3 Composition API 开发指南 |
| Vue 3 + Nuxt 3 + TypeScript | Vue 3 + Nuxt 3 全栈开发 |
🚀 后端框架 (14种) - Go, Java, Python, PHP, Elixir, Node.js, HTMX
| 规则 | 说明 |
|---|---|
| 后端通用规则（推荐）⭐ | 适用于所有后端项目的通用开发规范 |
| Convex Best Practices | Convex 后端开发最佳实践 |
| Deno Integration | Deno 集成开发指南 |
| Elixir + Phoenix + Docker | Elixir + Phoenix + Docker 开发 |
| Go Backend Scalability | Go 后端可扩展性开发 |
| Go Basic | Go 基础开发指南 |
| HTMX Basic | HTMX 基础开发指南 |
| HTMX + Flask | HTMX + Flask 开发指南 |
| Java + SpringBoot + JPA | SpringBoot + JPA 开发 |
| Laravel + PHP 8.3 | Laravel + PHP 8.3 开发 |
| Node.js + MongoDB | Node.js + MongoDB 开发 |
| Python FastAPI | FastAPI 开发最佳实践 |
| Python Django | Django 开发最佳实践 |
| TypeScript + NestJS | NestJS 开发最佳实践 |
📱 移动开发 (5种) - iOS, Android, Flutter, React Native
| 规则 | 说明 |
|---|---|
| React Native + Expo | React Native + Expo 开发 |
| SwiftUI Guidelines | SwiftUI 开发规范 |
| Android Jetpack Compose | Android Jetpack Compose 开发 |
| Flutter Expert | Flutter 专家级开发指南 |
| UIKit Guidelines | UIKit 开发规范 |
🎮 游戏开发 (4种) - Unity, Unreal, Cocos, LayaBox
| 规则 | 说明 |
|---|---|
| Unity (C#) | Unity C# 游戏开发规范 |
| Unreal Engine (C++) | Unreal Engine C++ 开发规范 |
| Cocos Creator (TypeScript) | Cocos Creator TypeScript 开发 |
| LayaBox (TypeScript) | LayaBox H5 游戏开发 |
🎨 CSS & 样式 (3种) - Tailwind CSS
| 规则 | 说明 |
|---|---|
| Tailwind + Next.js | Tailwind + Next.js 样式开发 |
| Tailwind + React + Firebase | Tailwind + React + Firebase 开发 |
| HTML + Tailwind + JavaScript | HTML + Tailwind + JS 开发 |
🔄 状态管理 (3种) - Redux, MobX, React Query
| 规则 | 说明 |
|---|---|
| React + Redux + TypeScript | Redux 状态管理指南 |
| React + MobX | MobX 状态管理指南 |
| React + React Query | React Query 数据管理 |
🗄️ 数据库 & API (2种) - GraphQL, Axios
| 规则 | 说明 |
|---|---|
| GraphQL + Apollo Client | GraphQL + Apollo Client 开发 |
| TypeScript + Axios | TypeScript + Axios API 开发 |
🧪 测试框架 (4种) - Cypress, Jest, Playwright, Vitest
| 规则 | 说明 |
|---|---|
| Cypress E2E Testing | Cypress 端到端测试 |
| Jest Unit Testing | Jest 单元测试 |
| Playwright E2E Testing | Playwright 端到端测试 |
| Vitest Unit Testing | Vitest 单元测试 |
🌐 托管部署 (1种) - Netlify
| 规则 | 说明 |
|---|---|
| Netlify | Netlify 部署和配置指南 |
🔧 构建工具 (3种) - Chrome扩展, Git, TypeScript规范
| 规则 | 说明 |
|---|---|
| Chrome Extension (JS/TS) | Chrome 扩展开发指南 |
| Git Commit Messages | Git 提交消息规范 |
| TypeScript Code Convention | TypeScript 代码规范 |
💻 编程语言 (4种) - Python, R, C++
| 规则 | 说明 |
|---|---|
| Python Best Practices | Python 开发最佳实践 |
| Python Developer | Python 开发者指南 |
| R Best Practices | R 语言开发最佳实践 |
| C++ Programming Guidelines | C++ 编程规范 |
📂 其他 (2种) - 通用规范
| 规则 | 说明 |
|---|---|
| Code Guidelines | 代码开发规范 |
| Optimize (DRY & SOLID) | DRY & SOLID 优化原则 |
选择类别 → 选择规则 → 添加完成
第一级：12 大技术类别
- 🎨 Frontend Frameworks & Libraries
- 🚀 Backend & Full-Stack
- 📱 Mobile Development
- 🎮 Game Development
- 🎨 CSS & Styling
- 🔄 State Management
- 🗄️ Database & API
- 🧪 Testing Frameworks
- 🌐 Hosting & Deployments
- 🔧 Build Tools & Development
- 💻 Language-Specific
- 📂 Other
第二级：65 种精选规则
- 涵盖主流技术栈和最新技术
- 来自 GitHub awesome-cursorrules (35k+ stars) + 定制通用规则
- 包含完整开发规范
- 提供代码示例和最佳实践
- ⭐ 特别推荐：前端/后端通用规则（适用于所有项目）
- 覆盖：用新规则替换现有规则
- 合并：将新规则追加到现有规则（自动添加分隔符）
- 取消：保持现有规则不变
添加成功后可以：
- 点击"查看文件"按钮立即查看规则内容
- 在项目根目录找到
.cursorrules文件
-
添加规则到项目
# 在项目根目录 HT: 添加 Cursor 规则文件 -
提交到仓库
git add .cursorrules git commit -m "feat: 添加项目 Cursor 规则" git push -
团队成员
- 克隆项目后自动获得规则
- 团队保持统一的 AI 辅助标准
项目 A (React + Next.js)
└── .cursorrules (React + Next.js 规则)
项目 B (Vue + Nuxt)
└── .cursorrules (Vue + Nuxt.js 规则)
项目 C (Spring Cloud)
└── .cursorrules (Spring Cloud 规则)
每个项目独立管理规则，互不影响。
场景：项目使用多种技术栈
1. 添加 React + Next.js 规则
2. 选择"合并"
3. 添加 Python FastAPI 规则
4. 选择"合并"
5. 添加 Jest 测试规则
结果：.cursorrules 包含三种技术栈的规则
// 包含内容：
- React Hooks 使用规范（useState, useEffect, useCallback, useMemo）
- Next.js 13+ App Router 架构
- 服务端组件 vs 客户端组件
- API Routes 和 Server Actions
- 数据获取和缓存策略
- 图片和字体优化
- TypeScript 最佳实践
- 性能优化技巧// 包含内容：
- Spring Boot 应用结构
- REST API 设计规范
- Service 层事务管理
- JPA 实体和 Repository
- Feign Client 服务调用
- 全局异常处理
- Redis 缓存配置
- 服务发现和配置中心
- 断路器和熔断机制
- 分布式追踪// 包含内容：
- MonoBehaviour 生命周期
- 组件模式和设计
- 协程和异步操作
- 对象池优化
- 事件系统
- ScriptableObject 数据管理
- 性能优化技巧
- 内存管理- 28 种精选规则，覆盖主流技术栈
- Vue 生态特别完善：5种规则（Vue2/Vue3 + JSX + Nuxt）
- 规则质量高，内容详尽（1000-2000+ 行）
- 包含完整代码示例和最佳实践
- 部分规则专门定制（Vue2, React+Next.js, Spring Cloud, Objective-C, 游戏开发）
- 持续更新和优化
- 三步完成：打开命令面板 → 选择规则 → 添加完成
- 智能管理：覆盖、合并、取消三种模式
- 即时查看：添加后立即查看规则内容
- 支持多人协作
- 统一团队规范
- 提高代码质量
Q: 什么时候需要使用 .cursorrules？
A: 当你希望 Cursor AI 更了解你的项目，提供更准确的代码建议时。特别是在团队协作、大型项目、特定技术栈项目中。
Q: 如何选择合适的规则？
A: 根据项目使用的技术栈选择。例如：React 项目选择 React 规则，Vue 项目选择 Vue 规则，全栈项目可以合并多个规则。
Q: 可以同时使用多个规则吗？
A: 可以！使用"合并"模式添加多个规则，规则会自动按分隔符合并到同一个文件中。
Q: 规则添加后如何生效？
A: Cursor AI 会自动读取项目根目录的 .cursorrules 文件，无需重启。
Q: 如何更新规则？
A: 重新运行添加命令，选择"覆盖"模式即可更新为最新规则。
Q: 规则文件在哪里？
A: 在项目根目录的 .cursorrules 文件，与 package.json 同级。
Q: 可以自定义规则吗？
A: 可以！添加规则后，直接编辑 .cursorrules 文件，添加项目特定的规则。
Q: VSCode 中能用吗？
A: 可以！插件同时支持 Cursor 和 VSCode，但 .cursorrules 功能在 Cursor 中效果最佳。
遇到问题或有建议？欢迎反馈：
核心功能
- ✨ 支持 28 种精选技术栈规则
- 🎯 两级选择系统（类别 → 规则）
- 📁 子文件夹分类管理
- 🔄 智能规则管理（覆盖/合并/取消）
规则分类
- 🎨 Frontend (9 种)：Vue 2/3 系列（5种）, React 系列（2种）, Angular, SvelteKit
- 🚀 Backend (6 种)：Go, Java SpringBoot, Spring Cloud, PHP, Python FastAPI, Python Django
- 🎮 Game (4 种)：Unity (C#), Unreal (C++), Cocos (TypeScript), LayaBox (TypeScript)
- 📱 Mobile (5 种)：React Native, SwiftUI, Objective-C, Android Jetpack, Flutter
- 🧪 Testing (4 种)：Cypress, Playwright, Jest, Vitest
特色规则
- Vue 2 Options API 完整开发指南（1000+ 行）
- React + Next.js 全栈开发最佳实践
- Spring Cloud 微服务架构指南（2000+ 行）
- Objective-C iOS 开发规范（1500+ 行）
- 游戏开发规则（Unity, Unreal, Cocos, LayaBox）
查看完整 CHANGELOG.md
感谢以下资源和社区：
- Cursor AI 官方文档
- 所有贡献者和使用者
⭐️ 觉得好用？给个 Star 支持一下！
🎉 享受高效的 Cursor AI 编码体验！