Cursor Rules配置实战：让你的AI编程助手真正理解项目架构

2026-07-08 · 小白基础技术分享

为什么Cursor有时生成的代码很”陌生”？

很多开发者都有这样的体验：在同一个项目中，Cursor有时产出完美契合项目风格的优雅代码，有时却像是一个完全不了解你项目的”外人”写的。问题往往不在于AI模型本身，而在于你没有告诉它你的项目规则。

本文将带你从零开始配置Cursor Rules，让AI编程助手真正”懂”你的项目。

第一步：了解规则文件的两种格式

Cursor支持两种规则配置方式：

旧版（兼容）：项目根目录下的 `.cursorrules` 单个文件。简单直接，但不支持按文件类型分规则。

新版（推荐）：`.cursor/rules/` 目录下的 `.mdc` 文件。支持多规则文件、文件类型匹配、条件触发等高级功能。

本教程使用新版格式。确保你的Cursor版本在0.45以上。

第二步：创建第一条规则

在项目根目录创建 `.cursor/rules/` 目录，然后新建 `global.mdc`：

---
description: 全局编码规范
globs: "**/*"
alwaysApply: true
---

## 编码规范

- 使用TypeScript，禁用any类型
- 函数必须有JSDoc注释
- 组件使用函数式组件 + Hooks
- 文件命名使用kebab-case
- 每个函数不超过50行
- 使用ESLint + Prettier，配置已存在于项目中

保存后，Cursor会自动读取这个文件，并在每次AI对话中注入这些规则。

第三步：按文件类型配置专门规则

不同文件类型需要不同的规则。创建 `react.mdc`：

---
description: React组件规范
globs: "**/*.tsx"
alwaysApply: false
---

## React组件规范

- 使用Next.js 14 App Router
- 服务端组件优先，仅在需要交互时使用'use client'
- 数据获取使用Server Actions
- 样式使用Tailwind CSS
- 组件Props必须定义接口，导出接口

`globs: “**/*.tsx”` 表示这个规则只在编辑 `.tsx` 文件时生效。`alwaysApply: false` 表示Cursor只在相关文件类型时引用。

同样可以创建API路由规范（`api.mdc`）：

---
description: API路由规范
globs: "**/api/**/*.ts"
alwaysApply: false
---

## API规范

- 使用Next.js Route Handlers
- 所有API返回统一格式: { success, data, error }
- 使用Zod验证请求参数
- 错误统一用try-catch包装，返回对应HTTP状态码

第四步：添加代码示例让AI有样可学

最有价值的规则不是指令，而是代码示例。在规则文件中直接嵌入参考代码：

## 组件结构示例

import { FC } from ‘react’

export interface ButtonProps {

label: string

variant: ‘primary’ | ‘secondary’

onClick: () => void

}

export const Button: FC = ({ label, variant, onClick }) => {

return (

className={`px-4 py-2 rounded ${variant === ‘primary’ ? ‘bg-blue-500’ : ‘bg-gray-200’}`}

onClick={onClick}

{label}

)

}

有了这个示例，当你让Cursor”创建一个新组件”时，它会更倾向于生成相同风格的代码。

第五步：高级技巧——条件规则和动态上下文

Cursor Rules的MDC格式支持三种触发方式：

| 触发方式 | 说明 | 适用场景 |

|———|——|———|

| `alwaysApply: true` | 始终生效 | 全局编码规范 |

| `globs` 匹配 | 匹配到对应文件时生效 | 语言/框架特定规则 |

| Agent Requested | AI根据对话内容自行决定是否引用 | 可选的高级规则 |

推荐的规则文件结构：

.cursor/rules/
├── global.mdc         # alwaysApply: true，全局规范
├── typescript.mdc     # globs: "**/*.ts"，TS特定
├── react.mdc          # globs: "**/*.tsx"，组件规范
├── api.mdc            # globs: "**/api/**"，API规范
└── testing.mdc        # globs: "**/*.test.*"，测试规范

配置完成后，测试一下：让Cursor”添加一个登录表单组件”，观察它是否自动遵循了你的规则。如果某条规则没有被遵守，检查glob模式是否正确匹配了目标文件。

**核心要点**：Cursor Rules是AI编程效率的分水岭。不配规则，AI像”外包团队”——代码风格飘忽不定。配好规则和示例，AI就是”懂你项目的资深同事”。建议从全局规范开始，逐步细化到文件类型级别的规则。

👇 关注不错过

— END —
LC 智趣厅 · 科技与生活的交点
ihygg.cn