深入解析 Cursor AI 的规则配置,通过项目级和全局规则的灵活运用,让 AI 助手精准贴合个人与团队的编码规范,显著提升开发效率和代码质量。
智能速览
项目级规则优先级最高,能覆盖全局设置
.mdc 文件支持 Always、Auto-attached 等四种挂载模式
利用 @file 语法可实现规则的模块化管理
React/TS 实战案例展示了如何约束代码结构和类型安全
可设定测试覆盖率等硬性指标,保障项目质量
精华内容
掌握 Cursor AI 规则,意味着将 AI 从通用工具打磨为量身定制的专属伙伴。下面将从配置原理到实战案例,层层拆解其强大功能。
规则优先级
Cursor 的规则具有明确的层级:项目级规则的权重最高,会直接覆盖全局设置。旧版的 `.cursor-rules` 文件已被官方弃用,应迁移至新的 `.mdc` 格式。全局规则在用户设置中配置,作为所有项目的底色,而项目级规则则允许针对特定需求进行精准定制,实现专款专用。
四种挂载模式
项目级规则支持四种挂载模式。`always` 类型会自动应用于所有对话,适合设定全局编码风格。`auto-attached` 则最智能,根据文件后缀(如 `.tsx` 或 `.test.ts`)自动加载对应规则。`agent-requested` 在任务描述匹配时激活,而 `manual` 需要手动选择,适用于偶尔使用的特殊场景。
React/TS 实战
以 React 和 TypeScript 项目为例,可精细化配置规则。在 `base.mdc` 中强制 kebab-case 命名和函数长度限制。`react.mdc` 可要求 AI 仅写函数组件,并按类型定义、常量、组件实现、样式的顺序组织代码。`typescript.mdc` 则能禁止使用 `any`,强制类型收窄,并开启 strict 模式,从源头保障代码健壮性。
模块化与管理
为避免规则文件臃肿,推荐使用 `@file` 语法实现模块化。可将通用基础规范写入一个文件(如 `base.mdc`),再在其他规则文件中引用它。这种方式如同管理代码一样管理 AI 规则,既保证了统一性,又提升了可维护性。创建新规则可直接通过命令面板快捷操作,十分高效。
通过这套规则系统,Cursor AI 不再是简单的代码生成器,而是深度融入开发流程的智能伙伴。它能让团队代码风格统一,让个人开发效率倍增。你是否也想为自己的项目打造一套专属的 AI 守护规则呢?