Cursor Rules 生成器
为 Cursor AI IDE 生成 .cursorrules 文件。选择技术栈,设置编码规范。
One rule per line. These will appear as bullet points in the generated file.
.cursorrules Preview
# Project: Untitled # Generated by DevTk.AI ## Language & Framework - Language: (not specified) - Framework: (not specified) ## Code Style - Indentation: 2 Spaces - Naming convention: camelCase
如何使用此工具
- 从下拉菜单中选择你的编程语言 —— 这决定了生成规则中的语言特定编码规范。
- 选择你使用的框架(React、Next.js、FastAPI、Express 等),获取框架感知的规则和最佳实践。
- 使用「快速预设」一键填充常见技术栈的配置,如 React + TypeScript 或 Python + FastAPI。
- 自定义编码风格(缩进方式、命名约定),使其符合你团队的标准。
- 在文本区域中添加额外的自定义规则 —— 每行一条。
- 复制生成的 .cursorrules 内容,保存为项目根目录下的 `.cursorrules` 文件即可生效。
什么是 .cursorrules,为什么它很重要
.cursorrules 文件是一个配置文件,用于告诉 Cursor AI IDE 如何在你的项目中编写代码。它定义了编码规范、首选库、应遵循或避免的模式,以及其他指导 AI 生成代码的规则。你可以把它理解为一份 AI 能读懂的代码风格指南。
如果没有 .cursorrules 文件,Cursor 的 AI 会自行假设代码风格、命名约定和设计模式,这往往导致生成的代码与现有代码库风格不一致。有了精心编写的 .cursorrules 文件,AI 生成的每一段代码从一开始就遵循你团队的规范。
.cursorrules 是 Cursor 特有的格式,但同类概念已在其他 AI 编码助手中普及:GitHub Copilot 使用 `copilot-instructions.md`,Claude Code 使用 `CLAUDE.md`,Windsurf 使用 `.windsurfrules`。如果你同时使用多个 AI 编码工具,可以基于同一份规则生成不同格式的配置文件。
.cursorrules 的最佳实践:明确指定技术栈和版本号;包含命名约定、文件结构偏好和测试要求;列出推荐使用和禁止使用的库;控制文件在 500 行以内(规则过多反而会让 AI 混淆);随着项目演进持续更新规则。
最后更新:2026 年 2 月
常见问题
什么是 .cursorrules 文件?
.cursorrules 文件告诉 Cursor AI IDE 如何在你的项目中编写代码。它定义编码规范、首选库、应遵循或避免的模式,以及其他引导 AI 生成代码符合团队标准的规则。
文件放在哪里?
将 .cursorrules 文件放在项目根目录。Cursor 会自动检测并将其应用于该项目中的所有 AI 交互。
其他 AI IDE 也能用吗?
.cursorrules 格式是 Cursor 专用的,但生成的规则可以改编用于其他 AI 编码工具。许多开发者也会将类似规则作为 ChatGPT 或 Claude 的 System Prompt 来请求代码帮助。
.cursorrules 和 CLAUDE.md 有什么区别?
.cursorrules 供 Cursor IDE 的 AI 功能读取,而 CLAUDE.md 供 Claude Code(Anthropic 的命令行工具)读取。两者目的相同 —— 引导 AI 代码生成 —— 但格式不同。.cursorrules 是纯文本的直接指令,CLAUDE.md 通常使用 Markdown 格式并包含结构化章节。
新的 .mdc 格式是怎么回事?
Cursor 推出了 .mdc(Markdown Configuration)格式作为 .cursorrules 的进化版本。.mdc 格式支持结构化元数据、条件规则和更高级的配置。不过 .cursorrules 仍然被广泛支持,对大多数项目来说是更简单的选择。Cursor 同时识别这两种格式。
团队协作时 .cursorrules 应该提交到 Git 仓库吗?
强烈建议提交到 Git 仓库。.cursorrules 文件是团队编码规范的一部分,提交后所有团队成员都能共享统一的 AI 编码规则,避免不同开发者生成的代码风格不一致。可以在 Code Review 中把 .cursorrules 的更新纳入讨论范围。