awesome-cursorrules：给 Cursor AI 编辑器配一套项目规则库

这个仓库在 GitHub 上拿了 40,108 Star。

awesome-cursorrules 做的事情很直接：收集和整理 Cursor AI 编辑器的项目规则文件（.mdc 格式），按技术栈分类，让开发者可以直接拿来用。

1、Cursor 的项目规则是什么

Cursor AI 是一个带 AI 辅助功能的代码编辑器。它的项目规则是一类 Markdown 文件，扩展名是 .mdc，放在项目根目录的 .cursor/rules/ 下面。

这些规则文件的作用是告诉 Cursor：在这个项目里，你应该怎么写代码。包括用什么框架、遵循什么命名规范、采用什么架构模式、避免哪些常见错误。

默认情况下，Cursor 依赖通用的编程知识来生成代码。加上项目规则之后，它会根据你定义的上下文来调整行为，生成的代码更贴合你的项目实际。

2、为什么需要这个仓库

自己从零写 .mdc 规则文件门槛不低。你需要了解 Cursor 的规则语法，还要针对具体的框架和工具链写出有效的约束条件。大部分人写出来的规则要么太笼统（等于没写），要么太死板（限制了 Cursor 的正常发挥）。

awesome-cursorrules 把这件事做了前置工作。仓库维护者收集了社区贡献的各种规则文件，覆盖主流的技术栈，每个规则都经过实际项目验证。你需要做的只是找到对应的 .mdc 文件，复制到自己项目里。

3、覆盖了哪些技术栈

这个仓库的规则覆盖面很广，大致分成这些类别：

前端框架：React、Next.js、Vue、Nuxt、Svelte、SvelteKit、Angular、Solid.js、Astro、Qwik 等。其中 Next.js 的规则最多，从基础的 TypeScript 配置到 Supabase 集成、TanStack Query、SEO 优化都有单独的规则文件。

后端和全栈：Node.js、Python（FastAPI、Django、Flask）、Go、Java（Spring Boot）、Laravel、Rails、Elixir、Deno、Kotlin Ktor 等。还包括 Cloudflare Workers、Knative 这类 Serverless 方案。

移动端：React Native（Expo）、Flutter、SwiftUI、Jetpack Compose、NativeScript、HarmonyOS ArkTS。

其他类别包括：游戏开发（Unity、GameMaker、DragonRuby）、CSS 和样式（Tailwind、Styled Components、Chakra UI）、状态管理（Redux、Zustand、MobX、Pinia、TanStack Query）、数据库和 API（GraphQL、Snowflake）、测试（Cypress、Playwright、Jest、Vitest）、部署（Vercel、Netlify、Cloudflare）、语言专项（Rust、Python、TypeScript、Solidity、Fortran）。

安全和文档也有覆盖，包括 DevSecOps 规则和 README 最佳实践。

4、怎么用

步骤很简单：

1、装好 Cursor AI 编辑器。
2、在仓库里找到适合你技术栈的 .mdc 规则文件。
3、在项目根目录创建 .cursor/rules/ 文件夹（如果没有的话）。
4、把 .mdc 文件复制进去。
5、根据项目实际情况做适当调整。

规则文件的格式有要求。每个 .mdc 文件开头需要一段 frontmatter：

---
description: 一句话说明这个规则的作用
globs: **/*.ts, **/*.tsx
alwaysApply: false
---

description 字段告诉 Cursor 和其他贡献者这个规则是干什么的。globs 字段指定规则自动匹配哪些文件。alwaysApply 设为 false 表示只在匹配的文件上生效，设为 true 表示对所有请求都生效。

5、规则的实际价值在哪

用好项目规则，最明显的效果是减少重复的人工修正。

没有规则的时候，Cursor 生成的代码经常需要手动调整：导入方式不对、命名风格不一致、用了项目已经废弃的库、忽略了框架特有的约束。每次修正都是打断思路的额外操作。

有了规则之后，这些修正变成了一次性的工作。你把规则写好放进去，后续的代码生成就自动遵循这些约束。对团队来说，共享的 .cursor/rules/ 目录保证了所有成员用同一套 AI 行为标准，不管谁在写代码，生成结果的风格和质量是一致的。

仓库里的规则还有一个特点：很多规则不只是教 Cursor “用什么”，还教它"不用什么"。比如 Next.js 的 Supabase 规则明确区分了 getSession 和 getUser 的安全差异，NestJS 的反幻觉规则会阻止已废弃或不存在的导入。这类负面约束对减少 AI 编码错误很有用。

6、仓库结构

仓库的 rules/ 目录下存放所有 .mdc 文件，文件命名遵循"技术栈-场景"的格式，比如 nextjs-typescript-cursorrules-prompt-file.mdc、python-fastapi-best-practices-cursorrules-prompt-file.mdc。

README 本身也是一份索引，按分类列出了所有规则的链接和一句话描述，方便快速查找。

仓库还提供了两个外部目录的链接：CursorList 和 CursorDirectory，可以在线浏览和搜索规则。

链接和一句话描述，方便快速查找。

仓库还提供了两个外部目录的链接：CursorList 和 CursorDirectory，可以在线浏览和搜索规则。