HT Cursor Rules

🚀 一键安装，一键配置！ 为 Cursor AI 快速添加编程规则的 VSCode/Cursor 扩展。提供前端、后端、游戏研发、原生开发、测试等 65 种精选规则模板。

---

🌟 GitHub 仓库

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️⃣ 选择规则：选择技术类别 → 选择具体规则 → 选择添加方式（覆盖/合并）→ ✅ 完成！

---

🎬 使用演示

视频演示

<video src="https://pingtai-img.shiyue.com/bbs/others/ai/ys-cursorrules.mp4" controls width="100%"></video>

效果预览

---

💡 使用场景

🌐 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？

.cursorrules 是 Cursor AI 的强大功能，允许开发者为项目定义专属的 AI 指令。

核心优势：

• ✨ 定制 AI 行为：根据项目需求定制 AI 响应，确保代码建议更相关、更准确
• 📏 保持一致性：定义编码标准和最佳实践，确保 AI 生成符合项目风格的代码
• 🎯 上下文感知：为 AI 提供项目重要上下文（常用方法、架构决策、特定库）
• ⚡ 提高生产力：精准的规则让 AI 生成的代码更少需要手动编辑，加速开发流程
• 👥 团队协作：共享 .cursorrules 文件确保团队成员获得一致的 AI 辅助

通过在项目根目录创建 .cursorrules 文件，您可以充分利用这些优势，提升 Cursor AI 编码体验。

---

📦 规则分类（63 种）

<details> <summary><strong>🎨 前端框架 (18种)</strong> - Angular, React, Vue, Svelte, Solid.js, Qwik, Astro</summary>

| 规则 | 说明 | |------|------| | 前端通用规则（推荐）⭐ | 适用于所有前端项目的通用开发规范 | | 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 全栈开发 |

</details> <details> <summary><strong>🚀 后端框架 (14种)</strong> - Go, Java, Python, PHP, Elixir, Node.js, HTMX</summary>

| 规则 | 说明 | |------|------| | 后端通用规则（推荐）⭐ | 适用于所有后端项目的通用开发规范 | | 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 开发最佳实践 |

</details> <details> <summary><strong>📱 移动开发 (5种)</strong> - iOS, Android, Flutter, React Native</summary>

| 规则 | 说明 | |------|------| | React Native + Expo | React Native + Expo 开发 | | SwiftUI Guidelines | SwiftUI 开发规范 | | Android Jetpack Compose | Android Jetpack Compose 开发 | | Flutter Expert | Flutter 专家级开发指南 | | UIKit Guidelines | UIKit 开发规范 |

</details> <details> <summary><strong>🎮 游戏开发 (4种)</strong> - Unity, Unreal, Cocos, LayaBox</summary>

| 规则 | 说明 | |------|------| | Unity (C#) | Unity C# 游戏开发规范 | | Unreal Engine (C++) | Unreal Engine C++ 开发规范 | | Cocos Creator (TypeScript) | Cocos Creator TypeScript 开发 | | LayaBox (TypeScript) | LayaBox H5 游戏开发 |

</details> <details> <summary><strong>🎨 CSS & 样式 (3种)</strong> - Tailwind CSS</summary>

| 规则 | 说明 | |------|------| | Tailwind + Next.js | Tailwind + Next.js 样式开发 | | Tailwind + React + Firebase | Tailwind + React + Firebase 开发 | | HTML + Tailwind + JavaScript | HTML + Tailwind + JS 开发 |

</details> <details> <summary><strong>🔄 状态管理 (3种)</strong> - Redux, MobX, React Query</summary>

| 规则 | 说明 | |------|------| | React + Redux + TypeScript | Redux 状态管理指南 | | React + MobX | MobX 状态管理指南 | | React + React Query | React Query 数据管理 |

</details> <details> <summary><strong>🗄️ 数据库 & API (2种)</strong> - GraphQL, Axios</summary>

| 规则 | 说明 | |------|------| | GraphQL + Apollo Client | GraphQL + Apollo Client 开发 | | TypeScript + Axios | TypeScript + Axios API 开发 |

</details> <details> <summary><strong>🧪 测试框架 (4种)</strong> - Cypress, Jest, Playwright, Vitest</summary>

| 规则 | 说明 | |------|------| | Cypress E2E Testing | Cypress 端到端测试 | | Jest Unit Testing | Jest 单元测试 | | Playwright E2E Testing | Playwright 端到端测试 | | Vitest Unit Testing | Vitest 单元测试 |

</details> <details> <summary><strong>🌐 托管部署 (1种)</strong> - Netlify</summary>

| 规则 | 说明 | |------|------| | Netlify | Netlify 部署和配置指南 |

</details> <details> <summary><strong>🔧 构建工具 (3种)</strong> - Chrome扩展, Git, TypeScript规范</summary>

| 规则 | 说明 | |------|------| | Chrome Extension (JS/TS) | Chrome 扩展开发指南 | | Git Commit Messages | Git 提交消息规范 | | TypeScript Code Convention | TypeScript 代码规范 |

</details> <details> <summary><strong>💻 编程语言 (4种)</strong> - Python, R, C++</summary>

| 规则 | 说明 | |------|------| | Python Best Practices | Python 开发最佳实践 | | Python Developer | Python 开发者指南 | | R Best Practices | R 语言开发最佳实践 | | C++ Programming Guidelines | C++ 编程规范 |

</details> <details> <summary><strong>📂 其他 (2种)</strong> - 通用规范</summary>

| 规则 | 说明 | |------|------| | Code Guidelines | 代码开发规范 | | Optimize (DRY & SOLID) | DRY & SOLID 优化原则 |

</details>

---

✨ 核心功能

🎯 两级选择

选择类别 → 选择规则 → 添加完成

第一级：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 文件

---

🔧 高级用法

团队协作

1. 添加规则到项目

   # 在项目根目录
   HT: 添加 Cursor 规则文件
   

2. 提交到仓库

   git add .cursorrules
   git commit -m "feat: 添加项目 Cursor 规则"
   git push
   

3. 团队成员

   • 克隆项目后自动获得规则
   • 团队保持统一的 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 + Next.js 规则

// 包含内容：
- React Hooks 使用规范（useState, useEffect, useCallback, useMemo）
- Next.js 13+ App Router 架构
- 服务端组件 vs 客户端组件
- API Routes 和 Server Actions
- 数据获取和缓存策略
- 图片和字体优化
- TypeScript 最佳实践
- 性能优化技巧

Spring Cloud 规则

// 包含内容：
- Spring Boot 应用结构
- REST API 设计规范
- Service 层事务管理
- JPA 实体和 Repository
- Feign Client 服务调用
- 全局异常处理
- Redis 缓存配置
- 服务发现和配置中心
- 断路器和熔断机制
- 分布式追踪

Unity (C#) 规则

// 包含内容：
- MonoBehaviour 生命周期
- 组件模式和设计
- 协程和异步操作
- 对象池优化
- 事件系统
- ScriptableObject 数据管理
- 性能优化技巧
- 内存管理

---

🎯 为什么选择 HT Cursor Rules？

✅ 精选规则

• 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 中效果最佳。

---

🐛 问题反馈

遇到问题或有建议？欢迎反馈：

• 💬 GitHub Issues

---

📄 更新日志

1.0.0 (2025-11-12)

🎉 首次发布

核心功能

• ✨ 支持 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

---

📜 许可证

MIT License

---

🙏 致谢

感谢以下资源和社区：

• Cursor AI 官方文档
• 所有贡献者和使用者

---

⭐️ 觉得好用？给个 Star 支持一下！

⭐️ Star on GitHub

🎉 享受高效的 Cursor AI 编码体验！