<p>Cursor 1.0 必须将规则迁移到 .cursor/rules/ 目录下，使用 .mdc 文件格式（如 naming-convention.mdc），通过 globs 指定作用范围，并确保头部含 --- 分隔符；全局规则在 Settings 中配置，项目级规则在 .cursor/rules/ 下细化，二者叠加生效。</p>
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让Cursor生成的代码严格遵循团队命名规范、目录结构和接口调用方式，而不是每次自作主张换一套写法。
用 .cursor/rules/ 目录替代旧版 .cursorrules 文件
Cursor 1.0 已不再优先读取项目根目录的 .cursorrules 文件，它现在默认加载 .cursor/rules/ 下的 .mdc 规则文件。直接放 .cursorrules 会导致规则失效——【必须把规则迁移到 .cursor/rules/ 目录下】，否则所有约束形同虚设。
在项目根目录新建 .cursor/rules/ 文件夹，然后创建第一个规则文件，比如 naming-convention.mdc。
写一条真正起效的命名规则
打开 naming-convention.mdc，按 MDC 格式写入元数据头和约束：
---
description: "TypeScript 接口与常量命名规范"
globs: "**/*.ts, **/*.tsx"
alwaysApply: false
---
# 命名要求
- 接口名必须以 I 开头，例如 IUserProfile
- 常量全部大写加下划线，例如 MAX_RETRY_COUNT
- 函数名用 camelCase，禁止使用下划线
globs 字段决定了这条规则只在 .ts 和 .tsx 文件中生效，避免污染 JSON 或配置文件上下文。
分层设置全局 + 项目级规则
第一步：打开 Settings → General → Rules for AI，粘贴全局基础约束：
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
你是一个资深前端工程师，遵守：- 所有注释用英文，解释用中文 - 禁止使用 any 类型，必须用 unknown + 类型守卫 - 修改代码只动最小必要范围，不重写整文件
第二步：在 .cursor/rules/ 下新建 framework-constraint.mdc，专管技术栈：
---
description: "React + Ant Design 组件规范"
globs: "**/*.tsx"
alwaysApply: false
---
## 必须遵守
1. 所有组件必须是函数组件，禁用 class 组件
2. 表单统一用 Form + useForm，不用原生 form 元素
3. API 调用必须走 src/utils/request.ts 封装的 request 方法
全局规则兜底，项目规则细化，两者叠加才能覆盖完整开发链路。
验证规则是否生效
在任意 .tsx 文件里输入 /edit 指令，让 Cursor 生成一个用户列表组件。如果它自动用了 IUserInfo 接口名、request.get() 调用、且没出现 any 类型，说明规则已注入成功。
若仍生成 class 组件或直接 axios.create()，检查 .cursor/rules/framework-constraint.mdc 是否拼错 globs 路径，或是否漏了 --- 分隔符——【MDC 文件头部缺 --- 会导致整条规则被忽略】。
