Cursor AI 代码自动符合项目规范的关键是创建 .cursor/rules/project.mdc 规则文件，用明确可执行的中文 Markdown 条款定义命名、结构等要求，并启用 Rules Engine 后重启编辑器生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让 Cursor AI 生成的代码自动符合你项目的命名约定、目录结构、技术栈偏好和注释规范，而不是每次都要在聊天框里重复提醒“用 TypeScript 接口别用 type”“Kotlin 函数名必须小驼峰”，关键在于把口头要求变成编辑器能自动读取并执行的规则文件。
创建项目级规则文件夹与入口
第一步：在项目根目录下新建隐藏文件夹 【.cursor】；第二步：进入该文件夹，再新建子目录 【rules】；第三步：在 .cursor/rules/ 下创建一个纯文本文件，命名为 project.mdc（扩展名必须是 .mdc，Cursor 只识别此格式）。
这一步不能跳过或改名——Cursor 启动时会扫描 .cursor/rules/*.mdc，只加载该路径下的规则文件。若放错位置（比如放在 .cursorconfig.json 同级），规则完全不会生效。
写入可执行的中文规则条目
打开 .cursor/rules/project.mdc，直接用 Markdown 写下明确、无歧义、机器可判定的条款。每条规则必须满足：能被 AI 精准理解 + 有具体检查依据 + 不依赖主观判断。
✅ 正确示例：
• 所有 React 组件文件名必须以 Page.tsx 或 Component.tsx 结尾
• src/api/ 下所有 .ts 文件中，fetch 调用必须返回 Promise<apiresponse>></apiresponse>
• 每个 public 函数开头必须有 JSDoc，且含 @param 和 @returns 标签
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
❌ 错误示例：
• “保持代码简洁”（无法判定）
• “尽量使用函数式写法”（模糊、无触发条件）
• “不要写烂代码”（无定义、无上下文）
规则条目之间空一行即可，无需编号或加粗。Cursor 会逐行解析，遇到第一条匹配的规则就立即应用。
启用 Rules 引擎并验证是否生效
方法一：快捷键直达设置
Cmd + ,（Mac）或 Ctrl + ,（Windows/Linux）→ 左侧选 Editor → 展开 AI → 勾选 【Enable Rules Engine】 → 关闭设置面板
方法二：命令面板手动开启
Cmd + Shift + P → 输入 Settings: Open Settings (UI) → 搜索 rules engine → 找到对应开关并启用
⚠️ 注意：启用后必须重启 Cursor 编辑器，否则规则仍不加载。重启后，在任意已匹配规则路径的文件中输入关键词（如在 src/api/user.ts 中敲 fetchUser），观察 AI 补全是否自动带上类型断言和 as Promise<User> —— 若出现，说明规则已激活。
