AI 行为规则

如何在 Cursor 中使用项目特定规则和全局规则自定义 AI 行为

在 Cursor 中，你可以使用规则来控制底层模型的行为。你可以将其视为 LLM 的指令和/或系统提示（system prompt）。

在 Cursor 内部，我们主要有两种方式来定制 AI 的行为，以满足你的需求：

项目规则（Project Rules）

特定于项目的规则，存储在 .cursor/rules 目录中。当引用匹配的文件时，它们会自动包含。

全局应用于所有项目的规则，在 Cursor Settings > General > Rules for AI 部分进行配置。

请在以下章节中了解更多关于如何使用它们的信息。

项目规则（Project Rules）提供了一个强大而灵活的系统，具有路径特定的配置。项目规则（Project Rules）存储在 .cursor/rules 目录中，并提供对项目中不同部分的 AI 行为的精细控制。

以下是它们的工作方式：

语义描述（Semantic Descriptions）: 每个规则都可以包含对其应该何时应用的描述

文件模式匹配（File Pattern Matching）: 使用 glob 模式来指定规则应用于哪些文件/文件夹

自动附加（Automatic Attachment）: 当引用匹配的文件时，规则可以自动包含

引用文件（Reference files）: 在你的项目规则（Project Rules）中使用 @file 来包含它们作为应用规则时的上下文。

你可以使用 @file 引用规则文件，允许你将多个规则链接在一起

你可以使用命令面板（command palette）和 Cmd + Shift + P > New Cursor Rule 创建新规则。通过使用项目规则（Project Rules），你还可以获得版本控制的好处，因为它只是一个文件

用例示例：

特定文件类型的框架特定规则（例如，.tsx 文件的 SolidJS 首选项）

自动生成文件的特殊处理（例如，.proto 文件）

自定义 UI 开发模式

特定文件夹的代码风格和架构首选项

可以通过修改 Cursor Settings > General > Rules for AI 下的 Rules for AI 部分来添加全局规则（Global Rules）。如果你想指定应始终包含在每个项目中的规则，例如输出语言、响应长度等，这将非常有用。

为了向后兼容，你仍然可以在项目的根目录中使用 .cursorrules 文件。我们最终将在未来删除 .cursorrules，因此我们建议迁移到新的项目规则（Project Rules）系统，以获得更好的灵活性和控制。