Cursor Rules怎么配置代码审查规则？

写代码这件事，最怕的不是需求复杂，而是写完之后才发现哪里不对劲。

要是能在写的同时，就有个资深审查员一直在旁边盯着，那该多好。其实，Cursor就能做到这一点，关键就在于配置好项目级的Rules文件。

不妨先问自己一个问题：代码写得差不多了，有没有想过在它生成的第一行，就直接让它符合团队的规范？而不是等代码写完，再人工一行一行挑毛病。直接配置Rules文件，就能把规范塞进AI的思考路径里，让它从一开始就写得合规。

创建项目级Rules文件

首先，在项目根目录下新建一个文件夹，名字必须是

，不能搞错。然后在这个文件夹里新建一个以 .md 为后缀的规则文件，比如 。路径和后缀名必须严格匹配，否则Cursor根本不会加载。

文件开头必须包含YAML元数据块，格式如下：

---
name: production-code-review
description: 生产环境代码审查核心规则
---

元数据之后换行，直接写Markdown正文。正文内容就是你要教给AI的具体指令，不是注释，也不是说明文档——它是会参与AI推理的提示词。

编写可触发的审查规则

规则内容要聚焦“当AI看到什么代码时，该做什么判断”。不能只写抽象原则，必须带具体模式。

例如禁止生产环境出现 console 输出，写成：
「如果检测到 console.(log|warn|error) 调用，且当前文件路径包含 /src/ 但不包含 /test/，则必须替换为 logger.error/warn/info，并说明替换理由」

例如要求所有React组件Props必须类型化：
「任何新写的函数组件，其Props参数必须声明 interface 或 type，不得使用 any、object 或隐式 any。若未声明，需自动生成 Props 接口并标注默认值」

「生成或修改代码后，必须确保 ESLint 检查通过；若失败，应定位第一个 error 并修复，而非跳过」

启用并验证Rules生效

第一步：重启Cursor或重新打开项目文件夹，确保规则被索引。
第二步：在编辑器中打开一个已知触发点的文件（比如含 console.log 的JSX文件）。
第三步：选中该行 → 右键 → 选择「Ask Cursor」→ 输入“检查这段代码是否符合生产规范”。

如果Rules配置正确，AI回复中会明确引用你写的规则名称（如 production-code-review），并指出问题及修正方式。若只泛泛而谈“建议避免console”，说明规则未加载或匹配失败。

第四步：在聊天框输入 /rules list 查看当前项目已加载的规则列表，确认 code-review.md 出现在其中。