Cursor规则文件配置方法：在项目根目录创建.cursor/rules/文件夹，添加.mdc后缀的规则文件。每个文件可定义AI的代码风格、框架偏好、命名规范等。规则会自动应用于所有AI交互，让Cursor像了解你项目的资深同事一样精准输出代码。
Cursor的规则文件（Rules）是其最被低估的功能之一。通过简单的配置文件，你可以让AI准确理解你的项目规范、代码风格和技术栈偏好，生成的代码从第一次就符合团队标准。本教程从零开始教你配置Cursor规则文件，让AI编程效率再上一个台阶。需要Cursor Pro或更高计划才能充分使用规则文件功能，中国用户可通过tkcursor.com便捷购买。
什么是Cursor规则文件
Cursor规则文件是存放在项目中的配置文件，用于向AI传达项目特定的规范和偏好。它的作用类似于.eslintrc之于ESLint、.prettierrc之于Prettier——但它规范的是AI的行为。
规则文件解决的核心问题是：每次和AI对话都要重复说明”用TypeScript”、”用React函数组件”、”命名用camelCase”等项目规范。有了规则文件，这些信息会自动注入每次AI交互的上下文中。
规则文件的存放位置：
- 项目级规则：
.cursor/rules/文件夹下 - 文件格式：
.mdc后缀（Markdown with Context） - 可以有多个规则文件，按不同维度组织
创建第一个Cursor规则文件
第一步：创建目录结构
在项目根目录下创建 .cursor/rules/ 文件夹。可以通过终端命令：
mkdir -p .cursor/rules
第二步：创建规则文件
创建一个文件如 .cursor/rules/project-standards.mdc，内容示例：
规则文件使用Markdown格式编写，开头包含YAML前置元数据（frontmatter），指定规则的适用条件：
- description：规则描述，帮助AI理解何时应用此规则
- globs：文件匹配模式，指定规则适用的文件类型
- alwaysApply：是否始终应用（true则对所有交互生效）
第三步：编写规则内容
规则内容用自然语言描述即可，AI会理解并遵循。例如：
- “所有React组件使用函数式组件 + TypeScript”
- “API响应必须包含统一的错误处理格式”
- “CSS使用Tailwind，不使用内联样式对象”
- “变量命名使用camelCase，常量使用UPPER_SNAKE_CASE”
- “每个函数必须有JSDoc注释”
实用规则文件配置示例
示例1：前端React项目规则
适用于React + TypeScript + Tailwind项目：
- 使用React 18+函数组件，禁止class组件
- 状态管理用Zustand，不用Redux
- 样式用Tailwind CSS，不写自定义CSS文件
- 文件命名：组件PascalCase.tsx，工具函数camelCase.ts
- 所有组件props必须定义TypeScript interface
- 使用React Query处理服务端状态
- 导入路径使用@/别名
示例2：后端Node.js项目规则
- 使用Express.js + TypeScript
- 所有路由使用async/await，禁止回调
- 错误处理使用统一中间件，不在每个路由中catch
- 数据库操作通过Repository模式封装
- API响应格式：{ success: boolean, data?: T, error?: string }
- 环境变量通过config模块统一管理
- 日志使用Winston，分级别输出
示例3：按文件类型的条件规则
你可以创建只对特定文件类型生效的规则。例如创建 .cursor/rules/testing.mdc，设置globs为 **/*.test.ts, **/*.spec.ts，内容包含测试规范：使用Vitest、每个测试用describe/it结构、Mock外部依赖等。
规则文件的高级技巧
技巧1：分层组织规则
推荐的规则文件组织方式：
.cursor/rules/general.mdc— 全局代码风格规范.cursor/rules/frontend.mdc— 前端特定规范.cursor/rules/backend.mdc— 后端特定规范.cursor/rules/testing.mdc— 测试编写规范.cursor/rules/git.mdc— Git提交规范
技巧2：包含项目架构说明
在规则中描述项目的目录结构和模块职责，AI就能自动将新代码放在正确的位置。例如：”src/components/放UI组件，src/hooks/放自定义Hook，src/services/放API调用逻辑”。
技巧3：用中文编写规则
规则文件完全支持中文编写。对于中国开发者，用中文描述规范可能更清晰准确。AI同样能理解并执行中文规则。
技巧4：指定禁止行为
除了告诉AI”要做什么”，明确”不要做什么”同样重要。例如：”不要使用any类型”、”不要在组件中直接调用fetch”、”不要使用var声明变量”。
技巧5：提供代码示例
在规则中包含理想代码的示例片段，AI会模仿这种风格生成代码。一个好的示例比十句描述更有效。
规则文件常见问题排查
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 规则不生效 | 文件位置或格式错误 | 确认在.cursor/rules/下，后缀为.mdc |
| 规则冲突 | 多个规则文件矛盾 | 检查优先级，移除冲突内容 |
| AI忽略部分规则 | 规则过长被截断 | 精简规则，突出重点 |
| 规则影响了不相关文件 | globs设置过宽 | 缩小文件匹配范围 |
| 新规则未应用 | 缓存问题 | 重启Cursor或新建对话 |
配合订阅计划的建议
规则文件的效果与AI模型能力直接相关。使用Pro及以上计划的高级模型（特别是Claude Sonnet/Opus）时，规则文件的遵循度更高、生成的代码更符合规范。Free版本的基础模型可能无法完全理解复杂规则。
通过tkcursor.com购买Pro或Pro+账号，配合精心编写的规则文件，能让Cursor成为真正了解你项目的AI编程搭档。
