AI 编程 · 规则文件

.cursorrules 文件是什么？
连 .cursor/rules/*.mdc 一起讲清

你打开一个仓库,看到一个 .cursorrules 文件、或一个塞满 .mdc 的 .cursor/rules/ 文件夹,想知道它们是啥。简短答案:它们是 Cursor 的规则文件,纯 markdown,告诉 Cursor 编辑器怎么在你项目上干活。

唯一让人绕的,是 Cursor 有两套格式:一套旧的、一套新的。这就是每个是什么、放在哪,以及 .mdc 文件到底是什么。

两种格式

文件 放哪 是什么
旧 .cursorrules 仓库根目录一个文件 纯 markdown。仍然有效；Cursor 现在推荐新格式。
新 .cursor/rules/*.mdc .cursor/rules/ 文件夹里一个或多个 markdown 加一小段作用域头信息。

如果一个仓库两样都有,Cursor 更依赖 .cursor/rules/ 文件夹。旧的 .cursorrules 没坏,它只是同一个思路的上一代。

.mdc 文件是什么？

.mdc 文件就是顶部带一小段头信息的 markdown。那段头(frontmatter)给规则定作用域:一句描述,常常还有说明规则对哪些文件生效的文件 glob。头信息下面,就是普通 markdown,和你在任何地方写的标题、列表一样。

所以 .mdc 不是要新学的一门语言。它是一个顶部带点元信息的 markdown 文件。还不熟底下的语法,看 Markdown 怎么写。

放在哪

  • .cursorrules 放在仓库根目录,挨着 package.json 或你项目对应的根配置。
  • .cursor/rules/ 是根目录下的一个文件夹,装一个或多个 .mdc 文件。把规则拆到几个文件里(一个框架或一个概念一个),正是新格式的用意。

里面写什么（以及和其他文件的关系）

内容和每个 AI 规则文件装的是同一类东西:你的技术栈、约定、要跑的命令、边界。如果你仓库里还有 AGENTS.md 或 CLAUDE.md,它们为别的工具覆盖同样的内容。哪个工具读哪个文件的完整地图,看 我的 AI 工具读哪个规则文件？;里面具体写什么,看 AGENTS.md / CLAUDE.md 是什么？

用 NoteLoom 读你仓库里的 markdown

一旦看清这些全是 markdown,读它们就只是读 markdown。你仓库里的规则和文档,那些 AGENTS.md、CLAUDE.md、README.md,都是 markdown 文件,而 NoteLoom 直接在浏览器里打开文件夹,把它们在干净的 reading 视图里渲染出来,source 视图供你改、存回本地。

先说清边界:NoteLoom 没有任何 AI。它不会让 Cursor 听你的规则,也不连接 Cursor 或任何编程工具。它只打开、渲染、存回你的 markdown 文件。规则,以及编辑器听不听,都在你和你的工具之间。

用起来:用 Chrome / Edge / Arc 打开 app.noteloom.cc,挂载你的项目文件夹,读或改里面的 markdown 文档。直接存回本地,不上云、不用账号。

相关阅读

我的 AI 工具读哪个规则文件？ AGENTS.md、CLAUDE.md、.cursorrules、copilot-instructions，按工具对照。 AGENTS.md / CLAUDE.md 是什么？ 规则文件里写什么、怎么写一份。 copilot-instructions.md 是什么？ GitHub Copilot 的规则文件：放哪、写什么。 AI 编程规则文件怎么管理？ 一堆规则文件怎么保持有序、一致。 网页版 Markdown 编辑器 打开仓库文件夹，浏览器里读写它的 markdown。

FAQ

.cursorrules 文件是什么？
Cursor 编辑器的规则文件：放在仓库根目录的纯 markdown，描述你的项目（技术栈、约定、边界），让 Cursor 干活时有这些上下文。这是旧的单文件格式。新的做法是 .cursor/rules/ 文件夹里一个或多个 .mdc 文件。
.mdc 文件是什么？
顶部带一小段头信息（frontmatter）的 markdown，那段头给规则定作用域，比如一句描述、以及说明何时生效的文件 glob。头信息下面就是普通 markdown。所以它还是个任何编辑器都能读的文本文件。
.cursorrules 放在哪？
仓库根目录，挨着 package.json 或你项目对应的根配置。新的 .mdc 放在根目录的 .cursor/rules/ 文件夹里，可以有好几个，一个概念或框架一个。
.cursorrules 还是 .cursor/rules，用哪个？
Cursor 现在推荐 .cursor/rules/*.mdc 格式（支持作用域和多文件）。单个 .cursorrules 仍然有效，简单项目够用。Cursor 读哪个由 Cursor 定；两个都只是你写的 markdown。
.cursorrules 就是 markdown 吗？
是。旧的 .cursorrules 是纯 markdown，.mdc 是带头信息的 markdown。这和 AGENTS.md、CLAUDE.md 是同一种底层格式，所以这些规则文件读起来都一样。
能用 NoteLoom 这种 markdown 编辑器读这些吗？
内容是 markdown，读起来跟任何 .md 一样。NoteLoom 打开你的仓库文件夹，把里面的 markdown 文件（AGENTS.md、CLAUDE.md、README.md）渲染成干净视图、存回本地。它没有任何 AI：不会让 Cursor 听你的规则，只帮你读写 markdown 本身。
手机或 Safari 能用 NoteLoom 弄吗？
目前不行。NoteLoom 依赖浏览器的 File System Access API，当前支持 Chrome、Edge、Arc 这类 Chromium 系桌面浏览器；Firefox、Safari 和手机端暂不支持。

读一读你仓库里的规则文件

用 Chrome / Edge / Arc 打开 NoteLoom,挂载你的项目文件夹,在干净视图里读或改它的 markdown 文档。直接存回本地,不用装软件,也不用注册账号。

打开 NoteLoom 试试