Cursor Project Rules (.cursor/rules/*.mdc)：存放位置及工具读取方式

Cursor Project Rules 是存放在 .cursor/rules/ 中的 .mdc 文件，其 frontmatter 决定每条规则何时生效。Cursor 也会读取 AGENTS.md，以及在仓库外设置的 User Rules 和 Team Rules。

存放位置

• .cursor/rules/**/*.mdc，可包含子目录；.cursor/rules 中的普通 .md 文件会被忽略。
• 根目录及嵌套文件夹中的 AGENTS.md。
• 在 Cursor 设置中配置的 User Rules。
• 在团队控制面板中配置的 Team Rules。

格式

使用带 YAML frontmatter 的 Markdown，且必须使用 .mdc 扩展名。alwaysApply: true 表示始终应用该规则；alwaysApply: false 时，只有匹配的文件位于上下文中，globs 才会触发该规则；仅设置 description 时，由 Agent 决定是否应用。若未设置这些字段，则只有通过 @ 提及该规则时才会应用。

Front matter 键： descriptionglobsalwaysApply

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.

优先级与合并

依次为 Team Rules、Project Rules、User Rules。所有适用规则会合并；发生冲突时，优先采用顺序靠前的来源；强制执行的 Team Rules 无法关闭。嵌套的 AGENTS.md 会与父级文件合并，具体范围更窄的文件优先。

可读取该文件的工具

提示

• 在 globs 字段中使用逗号分隔多个 glob 模式。
• 每条规则控制在 500 行以内，并使用 @filename 引用文件，而不要直接粘贴文件内容。
• 规则不会影响 Cursor Tab，User Rules 也不适用于 Inline Edit。
• Cursor 文档已不再提及旧版 .cursorrules 文件；请将其移至 .cursor/rules/。

其他指令文件