前言

最近在使用 Cursor 进行编程辅助时，发现 AI 生成的代码风格和当前的代码风格大相径庭。而且有时它会输出很奇怪的代码，总是不符合预期。

遂引出本篇，介绍一下 Rules ，它就可以做一些规范约束之类的事情。

什么是 Cursor Rules？

简单来说，Cursor Rules 是一系列可配置的指令或约束条件，用于指导 Cursor 的 AI 助手在生成、修改或理解你的代码时的行为。

你可以把 Rules 想象成给你的 AI 助手制定的“公司规范”或“项目指南”。它告诉助手：

应该做什么： 比如“在修改 API 文件时，必须添加 Swagger 注释”。
不应该做什么： 比如“禁止使用 var 关键字”、“不要引入 common 库，除非绝对必要”。
如何做： 比如“使用 4 个空格缩进”、“字符串统一使用双引号”、“结构体字段必须使用驼峰”。

通过设置 Rules，可以确保 AI 生成或修改的代码符合你个人、团队或项目的特定风格、约定、最佳实践和安全要求，减少后续手动调整的工作量，并保持代码库的一致性。

Cursor Rules 分为2种

User Rules 全局生效，例如：总是以中文回答。
Project Rules 只对当前项目生效，通常配置一些框架规则，API 规范等。

Project Rules

如果是针对现有项目，可以直接让 Cursor 为你生成 Rules

/Generate Cursor Rules

在这里插入图片描述

实际的开发场景中，Rules 主要分为三个层级：

通用规则 (global.rules): 适用于所有项目和工作区，不论编程语言和使用的框架，例如变量驼峰命名等。
编程语言规则 (language.rules): 针对特定编程语言生效。例如，Go 使用标准库 net/http 进行 API 开发。
框架规则 (framework.rules): 针对特定框架或技术栈生效。

通用规则

示例规则：

代码风格：

// 强制在所有语言中使用 2 个空格缩进 (除非被语言/框架规则覆盖)
use_spaces: true
indent_size: 2// 要求 AI 在修改或生成代码时添加清晰的注释说明改动原因 (非强制，但强烈建议)
require_explanatory_comments: true

安全与最佳实践：

// 禁止生成或建议已知不安全的函数/模式 (通用层面，具体需在语言规则细化)
avoid_unsafe_functions: true// 要求 AI 优先考虑内存安全和性能 (通用指导原则)
prioritize_memory_safety_and_performance: true

AI 交互：

// 要求 AI 在每次使用 /edit 前都先询问确认 (避免意外覆盖)
confirm_before_edit: true// 限制 /edit 一次能修改的最大行数 (防止过大范围改动)
max_edit_lines: 100

编程语言规则

典型用途： 定义特定语言的语法约定、风格指南、语言特有的最佳实践、推荐/禁用的库或特性。

示例规则 (Python - python.rules):

// 遵循 PEP 8 风格指南 (作为基础)
style_guide: pep8// 强制类型提示 (Type Hints)：要求 AI 在生成函数/方法时添加参数和返回值的类型注解
require_type_hints: true// 指定字符串引号规则
string_quotes: single # 统一使用单引号 (')// 要求使用 `pathlib` 代替 `os.path` 进行路径操作 (更现代)
prefer_pathlib: true// 禁止使用 `print` 语句，要求使用 `logging` 模块进行输出 (适用于非脚本场景)
no_print_statements: true

框架规则

示例规则 (Next.js - nextjs.rules):

// 要求使用 Next.js 内置的 `Link` 组件进行客户端导航
use_next_link: true// 指定数据获取方法：优先使用 `getServerSideProps` 或 `getStaticProps`， 避免在组件顶层使用 `useEffect` 获取初始数据
data_fetching: server_side_or_static_props// 遵循 Next.js 特定的文件路由约定 (pages/api, pages/[slug].js 等)
follow_app_router_conventions: true # 如果使用 App Router (v13+)
follow_pages_router_conventions: true # 如果使用 Pages Router// 要求 API 路由处理函数遵循特定结构 (req, res) 或 (request: NextRequest)
api_route_structure: standard