如何在Cursor 0.45+ 版本中使用规则
步骤 #1:理解 Cursor 规则
包括我自己在内的很多团队成员,总是忘记在离开办公室前做某些事情。因此,我们设置了自己的规则和例程,以确保每次离开时都做这些事情。这基本上就是 Cursor AI 中规则的工作原理。 相比之下,Cursor 中的规则文件就像 AI 编码助手的指南。它告诉 AI 如何为您的项目编写代码,包括您使用的工具以及所有内容的组织方式。这有助于 AI 创建更好、更准确的代码。
步骤 #2:如何在 Cursor 中定义规则
Cursor 中的规则文件是 Cursor 中具有 .mdc
扩展名的特殊文件。基本上它是 Markdown。当 AI 工作时,Cursor 会首先读取此文件------这是它加载的第一个上下文片段。
添加您的"主要"入口规则文件
-
打开 Cursor
-
按
CMD + SHIFT + P
打开命令面板。 -
现在搜索
File: New Cursor Rule
-
并将其命名为
instructions
,然后按Enter
描述规则
-
在
description
字段中给它一个有用的名称 -
对于
Globs
,您可以将其留空或添加一个*
,它将充当通配符并将添加到每个聊天中。 -
现在,您可以将自定义全局指令添加到文件中。作为一个简单的例子,我指定了一个 TypeScript 和 Node.js 专家的角色。
例如,您可以使用规则告诉 AI 诸如"使用 TypeScript"、"遵循 ESLint 标准"、"在 React 中优先使用函数组件而不是类组件",甚至项目特定的规则,如"我们正在使用 Tailwind CSS 进行样式设置"或"不要使用任何已弃用的 API"。本质上,它是全局应用于您的项目的上下文。
步骤 #3:保持规则分离
现在,让我们回到我们的真实办公室示例。如果我们也有厨房的规则怎么办?在这种情况下,我们不会将它们写在与办公室规则相同的便条上。相反,我们会把它们放在一张单独的纸上,然后贴在厨房门上。因此,每个空间都有自己的规则。
步骤 #4:.cursor/rules
目录
随着项目变得越来越复杂,您可能需要针对 .ts
文件、.js
文件、.md
文件甚至整个子文件夹的特定规则。通过最近的更新 (0.45),Cursor 规则得到了升级,使这种分离成为可能。
这意味着您不仅可以像以前一样在 instructions.mdc
中编写全局规则和指南,还可以为单个文件扩展名和目录创建单独的指令。
注意:.cursorrule 文件已弃用
在旧的 Cursor 版本中,所有规则都在 .cursorrule 文件中定义。从 0.45 版开始,.cursorrule
仍然有效,但将在以后的版本中删除。
以前,我们必须将所有规则放在一个 .cursorrules 文件中。Typescript、数据库规则、UI 所有内容都放在一个地方。但这并不理想。有时,Agent 不知道要应用哪些规则,而且您无法具体说明。从技术上讲,它只是用不必要的信息填满了您的上下文窗口。
步骤 #5:指导 Agent
最重要的是,您可以使用这种方法构建一个完全自主的代理。为此,您需要在 Cursor 中启用代理模式,并在规则文件中描述应处理哪个脚本或文档。
可以理解的是,Cursor 团队删除了".cursorrules"扩展名,因为它低估了代理的强大功能。您不仅可以定义规则和策略,甚至可以使用这些规则控制代理。如果您在"代理模式"下使用它,您是在告诉代理如何行动,而不仅仅是列出规则。
步骤 #6:示例
一个简单的 .cursorrules 文件示例(仅供您理解)
步骤 #7:使用 @
引用文件
您可以使用 @ 符号进行文件引用。 编码愉快!🚀
最后贴出本文总结的思维导图,供大家更好的理解本文!