怎样让 Cursor AI 写的代码符合公司编码规范？

怎样让 cursor ai 写的代码符合公司编码规范？

你是否遇到过这种情况：用 Cursor AI 生成的代码，命名风格五花八门，注释要么缺失要么敷衍，甚至把项目明令禁止的库给引了进来？问题其实很明确：AI 并不知道你项目里那些“不成文”的规矩。它就像一个空降的顶尖程序员，技术一流，但对你们团队的“家法”一无所知。

想让 AI 的产出与公司规范严丝合缝？关键在于给它建立明确的“约束感知”。下面这五种方法，从静态配置到动态校验，能帮你系统性地解决这个难题。

一、配置项目级 .cursor/rules 文件

这是最根本、也最一劳永逸的方法。通过一个静态规则文件，向 Cursor 注入强制性的项目约束，让它每次动笔前都先读一遍“行为准则”。

具体操作分四步走：首先，在项目根目录下创建隐藏文件夹 .cursor，并在里面新建一个 rules 子目录。接着，在 .cursor/rules/ 路径下，创建一个名为 project_rules.md 的纯文本文件。

文件内容才是核心。规则必须明确、无歧义且可执行。建议至少写入5条具体指令，例如：“所有 Kotlin 函数名必须使用 lowerCamelCase，严禁出现下划线”；“网络请求层必须统一继承 BaseRemoteService 基类，且只能存放在 data/remote/impl 目录下”；“每个公开函数都必须包含完整的 KDoc 注释，首行简述功能，后续的 @param 和 @return 标签一个都不能少”。

文件保存后，重启 Cursor 编辑器，或者直接在聊天窗口执行 /reload rules 命令，新规则即刻生效。

二、使用 /generate rules 指令动态生成初稿

如果从头起草规则文件让你感到无从下手，别担心，可以让 AI 自己打一份草稿。这个方法特别适合缺乏规则制定经验的团队，能快速产出结构化草案，后续再人工精修即可。

操作很简单：在任意代码文件中，按下 Ctrl + L（Mac 是 Cmd + L）打开聊天窗口。然后，输入一条具体的指令，比如：/generate rules for Android Kotlin project using Jetpack Compose, with naming, package structure, and error handling requirements。

稍等片刻，AI 就会返回一份 Markdown 格式的规则建议。你只需要把全部内容复制到刚才提到的 .cursor/rules/project_rules.md 文件里。最后一步至关重要：人工逐条审查。删除那些无法验证或过于宽泛的表述（比如“保持代码简洁”），将其替换为可客观判定的具体规则（例如“每行代码长度不得超过 100 个字符”）。

三、在 Prompt 中嵌入 Mini-Spec 式技术约束

遇到一些对规范极其敏感的关键任务，比如核心模块开发，光靠通用规则可能还不够。这时，可以在单次提示语中，显式声明所有关键约束，形成一个临时但强效的“上下文锚点”。

方法是：在编辑器中选中目标区域，或者把光标放在空行，按下 Ctrl + K 调出 Composer。输入的提示语必须完整，格式应包含技术栈、行为限制和结构要求。举个例子：用 Kotlin + Jetpack Compose 实现 SettingsScreen。要求：① 使用 Material3 组件库；② 所有可点击元素必须带有 ripple 效果；③ ViewModel 必须继承自 BaseViewModel；④ 所有字符串必须从 strings.xml 资源文件引用；⑤ 严格遵循 .cursor/rules/project_rules.md 中定义的命名与包结构规则。

按下 Ctrl + Enter 提交后，AI 会优先匹配已加载的规则文件，对于文件未覆盖的细节，则会以你提示语中的要求为准。

四、启用 YOLO 模式并绑定规则校验流程

YOLO 模式能显著提升 AI 输出的完整性和连贯性，但它默认不负责检查代码是否符合规范。我们可以手动给它加上“质检”环节，形成一个“生成→验证→修正”的完整闭环。

首先，进入设置界面，找到 实验性功能（Features），打开 YOLO 模式 的开关。代码生成后，先别急着用，在聊天窗口输入：/check compliance against .cursor/rules/project_rules.md。

AI 会扮演审查员的角色，逐条比对当前代码与规则文件的冲突点，并给出具体反馈，例如：“检测到函数名 useDarkModeSwitcher 包含大写字母，违反了 lowerCamelCase 规则”。拿到反馈后，直接调用 Ctrl + K，输入修正指令即可：rename this function to useDarkModeSwitcher → useDarkModeswitcher。

五、通过 @ 符号注入已有代码上下文并施加规则锚定

在重构旧代码时，我们既希望 AI 能理解现有的复杂逻辑，又要求它严格按照新规范来重写。这时，“@上下文引用”加上“规则锚定”的组合拳就派上用场了。

操作流程如下：先选中待重构的代码块（比如一个基于旧版 XML 布局的 Activity 类）。然后右键选择 Ask Cursor，或者直接按 Ctrl + K。在指令中，需要明确重构目标和规范约束，例如：refactor this Activity into a Jetpack Compose Screen, using same state logic, and strictly follow the package structure and naming rules in .cursor/rules/project_rules.md。

这样一来，AI 会先解析所选代码的语义，然后在生成结果中确保所有细节都合规：UI 代码必须放在 ui/screen/ 目录下、ViewModel 类名必须以 ScreenNameViewModel 结尾、状态变量的命名必须符合 state_xxx 模式。这既保留了业务逻辑，又无缝切换到了新的规范体系。