先找到正确的设置入口
在Cursor中,系统提示词并不叫“系统提示词”,而是藏在Settings里的Custom Instructions(自定义指令)或Rules(规则)中。打开设置后,可以直接搜索“Rules”,会看到两个入口:一个用来写全局规则,另一个针对当前项目。全局规则会跟随所有对话,项目规则只对当前工作区生效。如果你希望代码风格统一,建议先配置全局规则,再在项目根目录下添加额外的项目规则文件(例如.mdc文件)来覆盖特定场景。注意,如果两处都写了内容,项目规则会叠加在全局规则之后,而不是替换。
这里先说明一下我自己的使用习惯:全局规则里只放我所有项目都通用的约定,比如缩进、命名和注释语言;项目规则才放当前项目特有的内容,比如某套框架的写法限制。这样切换项目时不会互相污染。配置完成后,你可以在设置面板里确认一下规则文件是否被正确加载,也可以在聊天窗口里直接输入“/rules”来查看当前生效的规则列表。注意“/rules”这个命令行目前在小版本上行为可能有差异,如果没反应,不妨直接在设置里搜索“Rules”。
把风格要求写成能检查的规则
编写控制代码风格的提示词时,最重要的不是形容词,而是可验证的具体约束。比如“使用两个空格缩进”“变量名采用camelCase”“函数尽量短小,不超过50行”这样明确的条件。更有效的是给出正反例:你可以在提示词中附上一小段代码,标明“这是推荐写法”和“这是不推荐写法”。模型会从示例中隐式学习你的风格偏好,比单纯描述规则更稳定。但也要注意,示例不要超过10行,否则会占用有限的上下文窗口,反而影响生成质量。
我平时写这类规则时,会尽量用“允许做什么、禁止做什么”的句式。比如在项目的 .cursor/rules 目录下新建一个 style.mdc 文件,内容可以写成这样:
# 代码风格规则
- 缩进:2 个空格,不使用 Tab
- 命名:变量和函数用 camelCase,常量用 UPPER_SNAKE_CASE
- 函数体:尽量控制在 30 行以内,超过就拆成多个小函数
- 错误处理:优先使用 early return,不要嵌套多层 if
- 注释:解释为什么这么做,而不是重复代码注意这里我写了 30 行,是示例,不要把这个当作固定的最佳值。像“推荐写法”这种可以不放文件里,而是直接写在对应代码块中。规则文件本身也属于上下文的一部分,所以不要堆太长。每条规则独立成行,尽量让模型能按行匹配。
规则之间会发生覆盖,需要知道优先级
自定义系统提示词虽然能影响生成风格,但它不是最高优先级。在具体对话中,如果你直接对Cursor说“这次改成4空格”,那么这一条临时指令会覆盖系统提示词中的相关规则。同样,项目规则也比全局规则更有针对性,当两者冲突时,以项目规则为准。但要注意,这种覆盖只在当前会话内生效,下次新对话时又会回到原有配置。因此,如果你发现某次生成不符合预期,先检查是不是最近的对话指令干扰了系统提示词。
这个覆盖关系在调试时很有用。如果你写好了规则,但生成结果不对,我建议先开一个新会话,只带着规则文件,不做任何额外说明,再试一次。如果新会话输出符合规则,那说明问题出在某条临时指令上;如果新会话也不对,再回去检查规则文件本身。项目规则和全局规则同时存在时,你可以在项目根目录下放一个 .cursorrules 文件来替代旧式的全局或项目配置,不过目前 Cursor 也支持用 .mdc 文件。我遇到过 .cursorrules 和 .mdc 同时存在的情况,此时项目根目录的 .cursorrules 通常会被优先读取。这个优先级需要结合你的 Cursor 版本确认,不要想当然。
提示词写得太抽象,等于没写
一个常见的坑是系统提示词写得过于宽泛或抽象,比如“写出优雅的代码”“保持高质量”,这样模型很可能会按照训练数据里的默认习惯来,而不是你的要求。另一个坑是提示词里同时包含太多风格要求,比如缩进、命名、注释、函数长度、依赖导入顺序等,全部挤在一起,模型容易丢失重点或顾此失彼。建议每条规则独立成行,最多不超过10条,优先保留你最在意的那些。如果发现生成的代码仍然风格混乱,可以把提示词精简到3条以内,测试看是否有改善。
我在实际处理时,会把规则文件分成两部分:前半部分放硬规则,比如缩进和命名,这些是可检查的;后半部分放软偏好,比如“注释尽量解释为什么而不是怎么做”这类,这类一般只有一条。如果规则太多,模型确实会顾此失彼。你可以用一个小实验来验证:把规则文件精简到只有“缩进 2 空格”和“变量 camelCase”两条,生成一个 20 行的小函数,看是否稳定遵守。如果仍然不稳定,可能不是规则问题,而是上下文里其他内容干扰了。
配置好后,先用小文件验证,再打补丁
配置好系统提示词后,不要急着用它写大型功能,先在一个小文件中做验证。你可以让Cursor生成一个包含函数、循环、条件语句的示例代码,检查它是否严格遵循了缩进、命名和注释规则。如果不符合,不要直接修改代码,而是回到提示词中打补丁。注意,提示词每次修改后都会在下次生成时生效,不需要重启软件。反复迭代几次后,你会发现自己的提示词会慢慢沉淀为一套有效的行为准则。不过,由于模型自身的随机性,即使提示词完全相同,两次生成也可能有细微差异,这属于正常现象。
这个打补丁的过程可以做得更具体一些。比如我要求“函数不超过 30 行”,但生成结果 40 行,我会先不修改代码,而是在规则文件里补一句“超过 35 行的函数必须拆分为多个辅助函数”,再重新生成同样的请求。如果两次生成结果不一致,不要急着否定规则,先把小文件跑通,再试更大的代码块。验证时最好准备一个简单的固定请求,比如“写一个读取 CSV 并统计每列空值的函数”,反复用来测试,这样可以减少变量。