Cursor Rules 完全指南(2026 最新版)

你有没有遇到过这种情况: 每次用 Cursor 写代码,都要重新解释项目架构、代码规范、命名风格、技术栈...... 感觉像在带一个每天失忆的实习生,累到怀疑人生?

今天介绍的 Rules,就是彻底解决这个问题的终极方案。

一、什么是 Rules?

Rules(规则)是 Cursor 的专属能力配置文件

你可以把 Cursor 看成一个聪明但没规矩的全能工程师。 他代码写得快,但不按你的规范来、记不住你的项目、每次都要从头教

而 Rules,就是给他定死的工作手册+纪律规范 。 加一个 go-rules,他就严格按 Go 官方规范写; 加一个 project-mem,他就永久记住你的项目上下文,跨会话不丢失。

Rules 能做什么?

  • 强制代码规范、命名风格、注释格式
  • 跨会话保存项目上下文,永久记忆
  • 特定语言/框架最佳实践(Go、Java、React、Rust 等)
  • 自动格式化、代码审查、错误预防
  • 自定义指令、快捷命令、团队共享规范

二、Rules vs 传统提示词:为什么不直接写 Prompt?

很多人说:"我直接复制粘贴长提示词不行吗?" 答案:行,但很蠢

传统提示词 = 便利贴 贴一次用一次,新开对话就丢,下次还要重写。

Rules = 永久工作手册 写一次,全局生效,所有对话共享,团队可同步。

对比项 传统提示词 Rules
复用性 每次复制粘贴 配置一次,永久生效
跨会话 必须重新输入 自动加载,永不丢失
触发方式 手动粘贴 自动生效,无感使用
团队协作 难以同步 可共享文件,统一规范
版本管理 无法追踪 可 Git 管理,支持更新

结论: 临时用一次 → 写 Prompt 长期开发、团队协作 → 必须用 Rules

三、三个核心概念,一次搞懂

1. Rule(规则)------最小配置单元

一条 Rule 就是一个具体约束,比如"Go 函数必须写注释""变量用小驼峰"。 必须放在 .cursor 目录,Cursor 才会识别。

2. Rules Pack(规则包)------最小使用单位

一个包包含多条 Rules,可按语言、项目、场景打包。 安装/导入时,规则包是最小单位

3. Rules Market(规则市场)------共享仓库

像应用商店,存放官方/社区优质规则包。

三者关系:

css 复制代码
Market(市场)
└── Pack(规则包)← 导入最小单位
 ├── rules.json(必需)
 ├── Rule A(规范)
 ├── Rule B(记忆)
 ├── Command(快捷指令)
 └── Hook(自动触发)

四、Rules 文件结构长什么样?

最简 Rules 只需要一个文件夹 + 一个文件:

javascript 复制代码
~/.cursor/rules/
└── my-rule/
 └── rules.md

核心规则:

  • 文件夹名 = 规则唯一标识
  • rules.md 固定文件名(小写)

rules.md 示例:

yaml 复制代码
---
name: go-standard
description: Go 语言官方规范 + 项目注释规则
---

编写 Go 代码时必须遵守:
1. 函数必须写注释,说明功能、参数、返回值
2. 包名用小写,简短且望文知意
3. 错误优先处理,禁止忽略 error
4. 变量使用小驼峰,常量全大写+下划线
5. 每行代码不超过 120 字符

关键点: description 是灵魂,Cursor 靠它判断什么时候激活这条规则

五、Rules 怎么触发?不用管!

99% 的 Rules 安装后自动生效,不用手动触发!

Cursor 会实时分析: 你打开的文件、项目结构、对话内容、技术栈 智能匹配最优 Rules,全自动执行

场景 自动激活 Rules
打开 Go 文件 go-standard、go-error 自动约束规范
新开项目对话 project-mem 自动加载历史上下文
写前端代码 react-rules、css-best-practices 自动生效
提交代码前 lint-rules 自动检查规范问题
问架构问题 arch-rules 给出最佳实践

只有少数自定义命令需要手动触发,如 /fmt/check/mem

总结:装好就忘,自然语言写需求,Cursor 自动按规矩干活。

六、两种安装方式

方式一:市场导入(推荐 90% 场景)

Cursor 官方 CLI,一键导入,自动更新。

1. 官方市场(优先)

bash 复制代码
# 添加官方市场(只需一次)
/rule market add https://github.com/getcursor/cursor-rules-official

# 安装规则包
/rule install go-pack@cursor-rules-official

2. 社区市场

sql 复制代码
/rule market add https://github.com/affaan-m/everything-cursor

# 安装全套规则包(60+ 规则)
/rule install everything-cursor@everything-cursor

3. 独立市场

ruby 复制代码
/rule market add https://github.com/obra/cursor-super-rules.git

/rule install super-rules@cursor-super-rules

三种市场对比:

对比项 官方市场 社区市场 独立市场
维护方 Cursor 官方 社区 社区
能否单选 ✅ 可以 ❌ 全装 ❌ 全装
质量 官方审核 自行判断 自行判断
推荐 ⭐⭐⭐ ⭐⭐ ⭐⭐

方式二:本地手动安装(特殊场景)

直接复制规则文件夹到本地目录,不联网也能用。

bash 复制代码
# macOS/Linux(全局)
cp -r <rule-folder> ~/.cursor/rules/

# 项目内(仅当前项目)
cp -r <rule-folder> ./.cursor/rules/

# Windows(全局)
Copy-Item -Recurse ".\rule-folder" "$env:USERPROFILE\.cursor\rules\"

# 安装后重启 Cursor 生效

适合场景:

  • 不上架市场的私有规则
  • 敏感项目,完全本地运行
  • 深度自定义规则源码
  • 离线开发环境

七、热门 Rules 推荐(精选必装)

everything-cursor(必装)

GitHub:affaan-m/everything-cursor | ⭐ 52k+ 黑客松冠军,打磨 10 个月,Cursor 最强规则合集

核心能力:

  • 60+ 规则覆盖全开发流程
  • 常用命令:/fmt、/check、/tdd、/mem
  • 支持 Go/Java/Python/React/Rust/Next.js
  • 自动审查、规范检查、部署提示

安装:

sql 复制代码
/rule market add https://github.com/affaan-m/everything-cursor
/rule install everything-cursor@everything-cursor

cursor-mem(必装)

GitHub:thedotmack/cursor-mem | ⭐ 23k+ 解决 Cursor 金鱼记忆,跨会话永久记住项目

再也不用:

  • 重复解释业务逻辑
  • 重复说明技术架构
  • 重复强调代码规范

自动压缩上下文,节省 Token,智能检索。

安装:

sql 复制代码
/rule market add https://github.com/thedotmack/cursor-mem
/rule install cursor-mem@cursor-mem

super-rules(必装)

GitHub:obra/cursor-super-rules | ⭐ 28k+ 核心贡献者出品,让 AI 像资深工程师一样思考

核心能力:

  • TDD 测试驱动开发
  • 结构化调试
  • 代码审查分级(Minor/Normal/Critical)
  • 自动生成实施计划

安装:

ruby 复制代码
/rule market add https://github.com/obra/cursor-super-rules.git
/rule install super-rules@cursor-super-rules

官方规则(按需安装)

先添加官方市场:

bash 复制代码
/rule market add https://github.com/getcursor/cursor-rules-official
规则包 说明 安装命令
code-fmt 自动格式化代码 /rule install code-fmt@official
rule-maker 自动生成自定义规则 /rule install rule-maker@official
code-lint 代码规范审查 /rule install code-lint@official
security-check 安全漏洞扫描 /rule install security-check@official
frontend-ui 前端组件规范 /rule install frontend-ui@official

冲突警告

装了 everything-cursor 就不要再装 plan-with-code 两者 /plan 指令冲突,前者功能更完整。

八、常见问题解答

Q:Rules 安装后不生效?

  1. 重启 Cursor
  2. 检查路径:~/.cursor/rules/xxx/rules.md
  3. 检查文件名:必须是 rules.md
  4. 输入 /rule 查看是否启用

Q:如何查看已装 Rules?

bash 复制代码
# 查看市场安装
/rule

# 查看本地安装(mac/Linux)
ls ~/.cursor/rules/

# Windows
dir "$env:USERPROFILE\.cursor\rules\"

Q:能只装大包里的某一条规则吗?

  • 市场导入:不能,包是最小单位
  • 本地安装:可以,单独复制文件夹

Q:Windows 导入失败?

  • 用 HTTPS 地址,别用 SSH
  • 配置 Git 代理
  • 改用本地安装

九、新手安装优先级

优先级 规则包 理由
第一 everything-cursor 60+ 规则全覆盖,闭眼装
第二 cursor-mem 解决记忆问题,长期必备
第三 super-rules 提升代码质量,工程化最强
4 code-fmt(官方) 自动格式化,省心
5 rule-maker(官方) 自己造规则,高度自定义

按场景推荐

  • 大型项目:everything-cursor + cursor-mem + super-rules
  • 追求规范:super-rules + code-lint
  • 国内创作者:baoyu-rules(文案、SEO、图表)
  • 离线环境:手动导入本地包

相关资源

装好 Rules 之后,你只需要用自然语言描述需求。 Cursor 会自动遵守规范、记住上下文、给出最佳实践。 不用记命令,不用反复解释,就像跟一个默契老同事合作。


各位互联网搭子,要是这篇文章成功引起了你的注意,别犹豫,关注、点赞、评论、分享走一波,让我们把这份默契延续下去,一起在知识的海洋里乘风破浪!

相关推荐
程序员陆业聪2 小时前
微前端状态管理的真相:Module Federation + 跨应用通信实战
前端
牛奶2 小时前
浏览器是怎么把代码变成页面的?
前端·javascript·chrome
flytam2 小时前
Claude Agent SDK 深度入门指南
前端·aigc·agent
weixin199701080162 小时前
《电天下商品详情页前端性能优化实战》
前端·性能优化
速易达网络2 小时前
vue+echarts开发的图书数字大屏系统
前端
小智社群2 小时前
贝壳获取小区的名称
开发语言·前端·javascript
Ferries3 小时前
《从前端到 Agent》系列|03:应用层-RAG(检索增强生成,Retrieval-Augmented Generation)
前端·人工智能·机器学习
Jessica_Lee3 小时前
Openclaw智能体终止机制
javascript
米丘3 小时前
Connect 深度解析:Node.js 中间件框架的基石
javascript·http·node.js