Cursor 项目规则怎么写?用 .cursor/rules 限定组件修改范围

以组件文件为例编写 Cursor .cursor/rules 中的 .mdc 规则,解释 glob 作用范围并给出实际生效与改动检查方法。

Cursor 项目规则要写在仓库的 .cursor/rules/中,并使用 .mdc文件。要限制组件修改范围,可用 globs只让规则在匹配的组件文件进入上下文时自动附加,再在规则正文写出能检查的约束。规则是给 Agent 的指引,不能代替 Git 差异审查或自动化测试。

先确定规则要解决的重复问题

假设团队反复遇到 Agent 改 React 组件时顺手修改服务层,目标应写成“组件任务只改组件及其样式;确需跨层时先说明原因”。这是教学场景,不是对某个真实仓库的诊断。先检查项目现有目录和规则,避免新增一份相互冲突的约束。Cursor 官方 Rules 文档建议规则聚焦、可执行,并优先引用现有规范文件。

Cursor 项目规则怎么写?用 .cursor/rules 限定组件修改范围

建立只作用于组件文件的 .mdc 规则

在项目根目录建立 .cursor/rules/components.mdc。以下示例假定组件位于 src/components/;你的仓库路径不同就改 globs:

---
globs: src/components/**/*.tsx
alwaysApply: false
---

处理 src/components 下的组件时:
1. 先阅读当前组件和相邻样式文件,再提出改动。
2. 默认只修改该组件及相邻样式;若需要修改 API 或服务层,先说明原因和影响文件。
3. 完成后列出修改文件与验证命令,不把未运行的测试写成已通过。

官方文档说明:项目规则是带 frontmatter 的 .mdc文件;当 alwaysApply: false且提供 globs时,匹配文件进入上下文后规则会自动附加。直接把普通 .md文件丢进 .cursor/rules/不会按项目规则识别。若只需简单的全项目说明,也可用项目根目录的 AGENTS.md,但不要把同一条要求散落在多个地方。

检查是否生效,以及如何避免误判

  1. 保存规则后,在 Cursor 的 Customize → Rules查看规则与状态;也可从 Agent 中用 /create-rule创建规则,官方文档列有这两个入口。
  2. 在一项真实组件任务中明确引用匹配的 .tsx文件,要求 Agent 先说明计划。核对它是否遵循“跨层修改先说明”的约束。
  3. 查看最终 diff:若它仍改了服务层,记录具体原因并修正规则或缩小任务范围。规则出现于上下文不等于每次行为都可靠。

Cursor 官方文档还说明,项目 Rules 作用于 Agent(Chat),不会控制 Cursor Tab 等其他 AI 功能。本文示例未在读者仓库中运行;实际 glob 是否匹配、规则是否与团队规则冲突,都需按当前项目和 Cursor 版本核对。资料核验日期为 2026 年 10 月 1 日。

Ai菜鸟网。发布者:AI小管家,转载请注明出处:https://www.alyyhw.com/29790.html

赞 (0)
AI小管家的头像AI小管家
Cursor 如何导入已有项目?打开本地目录并让 Agent 定位代码入口
上一篇 12小时前
DeepSeek API 怎么调用?用 Python 发出第一条对话请求
下一篇 12小时前

相关推荐

联系我们

联系我们

1

在线咨询: QQ交谈

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

关注微信
关注微信
分享本页
返回顶部