2026 年最佳 Cursor Rules 推荐（20 个）
一句话：Cursor Rules 是放在项目根目录的
.cursorrules文件，相当于项目的系统提示词——每次 AI 交互自动注入，告诉 Cursor 在你的项目里该怎么写代码。本文 20 个实战验证的规则，复制到项目根目录就生效。
前提：已安装 Cursor v0.45+。
什么是 Cursor Rules
把 .cursorrules 放到项目根目录（和 package.json 同层），Cursor 的所有 AI 功能——自动补全、聊天、Composer、内联编辑——都会读取它：
<!-- .cursorrules -->
你是资深 React 开发者。
## 代码规范
- 只用函数组件 + hooks
- TypeScript strict 模式
## 架构
- 按功能模块组织目录
- 单个组件不超过 200 行
- 公共逻辑提取为自定义 hook
前端规则（5 个）
1. React + TypeScript：只用函数组件禁 class 组件、strict 模式不用 any、全局状态 Zustand 局部 useState、Tailwind 原子类禁止 inline style。适合所有 React + TS 项目。
2. Vue 3 + Composition API：始终 <script setup lang="ts">、composables（use*）封装共享逻辑、状态只用 Pinia、禁止 Options API。适合从 Options API 迁移的项目。
3. Next.js App Router：默认 Server Components 只在必要时加 'use client'、Server Actions 处理数据变更、Metadata API 做 SEO、图片必须 next/image。只适合 App Router 项目。
4. Nuxt 3：用自动导入的 composables（useState/useRoute/useFetch）、server/api/ 放 Server Routes、默认 SSR 浏览器内容用 <ClientOnly>。
5. Tailwind CSS：组件里不写 @apply 直接用原子类、移动优先响应式、自定义值在 tailwind.config.ts 扩展不用任意值、间距用默认比例、颜色用主题色不硬编码 hex。
后端规则（5 个）
6. Go：显式处理错误禁止 _ 忽略 error、优先返回 error 不 panic、接口「接受接口返回结构体」、并发函数第一个参数是 context.Context、表驱动测试。
7. Python (FastAPI)：函数签名全部类型注解、Pydantic v2 定义 schema、路由 async def、Depends() 依赖注入、SQLAlchemy 2.0 async。
8. Node.js (Express/Hono)：ESM 导入禁 require、Zod 做请求校验、集中式错误处理中间件、dotenv 管理环境变量、pino 结构化日志。
9. Django：API 用 DRF、优先类视图、序列化器层做校验、自动生成的 migration 必须人工审查、用 Django 内置安全保护、pytest-django 测试。
10. Rust：参数优先 &str 不用 String、可失败操作用 Result 库代码禁 panic、库用 thiserror 应用用 anyhow、优先迭代器不手写循环、生命周期编译器要求时才标。
全栈规则（5 个）
11. T3 Stack（Next.js + tRPC + Prisma）：tRPC router 输入用 Zod 校验、Prisma 总用 select/include 避免过度查询、利用 tRPC 端到端类型推断。
12. MERN：Express + TS + Mongoose 后端、React + Vite 前端、JWT + httpOnly Cookie 禁 localStorage。
13. Laravel + Vue：Eloquent 关系 + Form Request 校验、Vue Composition API、Inertia.js 做 SPA 不需要 API 路由、Sanctum 认证。
14. Rails + React：胖模型瘦控制器、RSpec + FactoryBot、禁止直接改 schema 只用 migration。
15. Supabase：用客户端库不直连 PG、每张表必须启用 RLS——没有例外。
通用规则（5 个）
16. 代码风格：函数最长 30 行、文件最长 300 行、参数最多 4 个、禁魔法数字、注释写 WHY 不写 WHAT、禁止注释掉的代码（Git 记得一切）。
17. 测试标准：每个新函数至少一个测试、命名 describe("函数名") → it("should 做什么 when 条件")、Arrange-Act-Assert、测试间无依赖、mock 外部服务、覆盖率 80%+。
18. 安全：禁止硬编码密钥、SQL 必须参数化、服务端校验所有输入、CORS 生产禁通配符、密码 bcrypt cost 12+、JWT 短有效期 + httpOnly Cookie。
19. Git 提交：Conventional Commits（feat/fix/docs/refactor…）、标题 72 字符内祈使语气、body 解释 WHY、一提交一逻辑变更、禁提交生成文件和 .env。
20. 文档：公开函数 JSDoc 标注、README 含用途/安装/架构、文档和代码同一 PR 更新不留过期文档。
如何创建自己的 Cursor Rule
- 找模式：翻最近 20 个 PR 的评论，你在代码审查里重复说的前 10 件事就是你的规则
- 写文件：架构 / 代码规范 / 常用模式 / 项目特有反模式，四段结构
- 测试迭代：
echo "your rules" > .cursorrules，AI 忽略了哪条就写得更明确，导致坏输出的删掉 - 分享团队：提交到仓库
git commit -m "docs: 添加团队 Cursor 编码规范"
Cursor Rules vs Claude Code Skills
| 特性 | Cursor Rules | Claude Code Skills |
|---|---|---|
| 格式 | 单文件 .cursorrules | .claude/commands/ 下多个 .md |
| 激活 | 始终激活 | 按需触发 |
| 分发 | 仅 Git 仓库 | Git、TokRepo |
| 跨工具 | 仅 Cursor | Claude Code / Codex / Gemini |
| 最适合 | 编码规范 | 复杂工作流 & 自动化 |
很多开发者两个都用：Cursor 里配 Rules 强制编码规范，Claude Code 里装 Skills 跑复杂工作流。
常见问题
能用多个 .cursorrules 文件吗？
只能读根目录一个。不同模块需要不同规则就合并成一个文件的不同段落。
写多长合适？
200–400 行。太短 AI 凭直觉写，太长占上下文浪费 Token。优先写项目特有的架构、命名、禁止事项，通用风格让 ESLint/Prettier 管。
能用在其他 AI 助手上吗？
不能，.cursorrules 是 Cursor 专属。Claude Code 用 CLAUDE.md，Copilot 用 .github/copilot-instructions.md——内容可以互相复制，只是文件名不同。
和 CLAUDE.md 能共存吗？
可以且建议共存：两份内容保持一致，团队同时用 Cursor 和 Claude Code 时标准统一。