Cursor 中文文档

设置全局规则

1. 打开 Cursor Settings(设置)
2. 导航到 General(通用) > Rules for AI(AI 规则)
3. 在提供的文本区域中输入您的自定义指令
4. 点击 Save(保存) 应用您的全局规则
5. 请记得启用 include .cursorrules file(包含 .cursorrules 文件) 选项以应用项目特定规则

全局规则示例：

1. 错误修复：
   - 提出解决方案前彻底分析问题
   - 提供精确、有针对性的解决方案
   - 解释错误的根本原因

2. 保持简单：
   - 优先考虑可读性和可维护性
   - 避免过度设计解决方案
   - 尽可能使用标准库和模式

3. 代码更改：
   - 在进行更改前提出明确的计划
   - 一次性应用对单个文件的所有修改
   - 不要更改不相关的文件

创建项目特定规则

有两种方式创建项目特定规则：

1. 使用新的项目规则系统（推荐）

1. 转到 Cursor Settings(设置) > General(通用) > Project Rules(项目规则)
2. 点击 Add Rule(添加规则) 创建新的 .mdc 文件
3. 编辑 Description(描述)（帮助代理选择规则）和 Globs(全局模式)（例如 *.tsx 用于自动包含规则）
4. 在 .mdc 文件中编写您的规则

Cursor 将根据您的描述和 Glob 设置自动同步和应用这些规则。

2. 使用 .cursorrules 文件（向后兼容）

1. 在项目的根目录创建 .cursorrules 文件
2. 将您的自定义指令添加到此文件中

示例 .cursorrules 文件：

您是 TypeScript、Node.js、Next.js App Router、React、Shadcn UI、Radix UI 和 Tailwind 方面的专家。

代码风格和结构
- 编写简洁、技术性的 TypeScript 代码，提供准确的示例。
- 使用函数式和声明式编程模式；避免使用类。
- 优先使用迭代和模块化而非代码重复。
- 使用描述性变量名，含辅助动词（例如 isLoading、hasError）。
- 文件结构：导出组件、子组件、辅助函数、静态内容、类型。

命名约定
- 目录使用小写加连字符（例如 components/auth-wizard）。
- 组件优先使用命名导出。

TypeScript 使用
- 所有代码使用 TypeScript；接口优于类型。
- 避免枚举；使用映射代替。
- 使用带有 TypeScript 接口的函数组件。