Cursor AI 严格遵循团队编码规范需启用 Rules 引擎并重启编辑器，通过 .cursorconfig.json 或 .cursor/rules/project_rules.md 注入规则，支持 JSON 简单约束与 Markdown 多维度管理，并可用 /generate rules 快速生成初稿，配合日志调试确保生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让 Cursor AI 生成的代码严格遵循团队编码规范，不是靠反复口头提醒，而是通过规则文件把“项目宪法”直接塞进 AI 的上下文里——它读得懂、记得住、每次生成都照着执行。
启用 Rules 引擎并验证基础能力
第一步：打开 Settings → Editor → AI → 勾选 【Enable Rules Engine】。这步不操作，后续所有规则都不会生效。
第二步：重启 Cursor 编辑器。仅修改设置不重启，规则引擎仍处于休眠状态。
第三步：在任意 TypeScript 文件中输入 fetch，观察是否出现带类型推导和 as Promise<User> 的补全建议——若出现，说明引擎已激活；若无反应，检查是否漏掉重启步骤。
用 .cursorconfig.json 注入项目级硬约束
这是最轻量、最直接的方式，适用于单项目快速落地核心规范。
方法一：在项目根目录创建 .cursorconfig.json 文件，内容必须是合法 JSON：
{ "rule": "所有接口必须使用 interface 而非 type 定义；禁止出现 any 类型；函数参数必须有明确类型注解；每个导出函数需附带 JSDoc，包含 @param 和 @returns" }
方法二：保存后，新建一个 user.ts 文件，在空行输入 interface User → 按 Tab 触发补全，AI 会自动补出带 id: number、name: string 的完整结构，而非随意用 type User = {...}。
【注意：rule 字段值必须是字符串，不能是数组或对象，否则整个配置被忽略】
通过 .cursor/rules/project_rules.md 实现多维度规范管理
当项目需要分层约束（如架构路径、命名风格、错误处理模式），纯 JSON 已不够用，此时转入 Markdown 规则文件体系。
第一步：在项目根目录创建隐藏文件夹 .cursor，再在其下建 rules 子目录。
第二步：在 .cursor/rules/ 中新建 project_rules.md，写入 5～8 条可判定规则，例如：
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
- 所有 React 组件必须为函数式组件，文件名首字母大写，存放于 src/components/ 下；
- API 调用统一使用 apiClient.get<User>('/users/:id')，禁用原生 fetch 或 axios；
- Kotlin 文件中，公共函数必须以 KDoc 开头，且 @param 与 @return 不得缺失；
- 每个 useEffect 必须显式声明依赖数组，空数组需写成 [] 而非 [ ]（注意空格）。
第三步：执行命令面板（Cmd+Shift+P）→ 输入 /reload rules → 回车。无需重启编辑器，规则立即生效。
第四步：打开 src/pages/UserPage.tsx，输入 const UserPage = () =>，AI 会自动生成含 useState、useEffect（带正确依赖）、调用 apiClient.get 的完整组件骨架，而不是返回 class 组件或裸 fetch。
用 /generate rules 快速生成规则初稿
适合刚启动项目、缺乏规则起草经验的团队，避免从零憋文案。
在任意代码文件中按下 Cmd+L（Mac）或 Ctrl+L（Win/Linux）打开 Chat 窗口，输入：
/generate rules for Next.js 14 App Router project using TypeScript, with file structure, component naming, API route conventions, and error boundary requirements
等待 AI 返回 Markdown 格式草案，复制全部内容粘贴至 .cursor/rules/project_rules.md。
人工删减时重点砍掉三类条目：模糊表述（如“保持代码简洁”）、不可验证项（如“提升可读性”）、与当前技术栈无关的冗余规则（如生成了 Vue 相关约束但项目用 React）。
调试规则是否真正匹配
规则写了却没生效？别猜，直接看日志。
打开命令面板（Cmd+Shift+P）→ 输入 Cursor: Show Rules Logs → 回车。日志实时滚动，每条记录含 rule_id、matched_context 和 prompt_length。
当你在 api/user.ts 中输入 getUser 却未触发预期补全，就在日志里找 matched_context 是否包含 api/user.ts 路径 —— 若没有，说明 rules.json 或 project_rules.md 的 match 条件写错了。
