AI写代码自动遵循技术栈需配置.cursor/rules下的模块化.mdc规则文件，明确语言框架、目录结构、数据边界、测试要求及常见错误，每条规则短、确定、可执行，并通过globs或alwaysApply设定作用域。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让AI在写代码时自动遵循你的技术栈、目录结构和编码习惯，而不是每次都要口头提醒它“用TypeScript严格模式”“别直接调数据库”，关键在于写出真正能被Cursor识别并执行的规则文件，不是写作文也不是写说明书。
先确认规则存放位置和类型
打开项目根目录，检查是否存在 【.cursor/rules】 文件夹。不存在就手动创建——这是2026年3月起Cursor官方推荐的规则存放路径，旧版单文件 .cursorrules 已被弃用，强行使用会导致规则不生效。
全局规则（影响所有项目）存放在 Cursor 设置里的 User Rules；项目专属规则必须放在此处，且每个规则单独一个 .mdc 文件。
写规则前必须回答这5个问题
第一步：明确主语言与框架 → TypeScript + Next.js 15？Python + FastAPI？还是 Go + Gin？
第二步：确认目录结构是否固定 → 是否有 src/domain、src/infra、src/api？是否禁止新增顶层目录？
第三步：定义数据访问边界 → 数据库操作是否只允许走 repository 层？是否禁用 raw SQL？
第四步：测试要求是否强制 → 单元测试是否必须随业务代码一起生成？覆盖率阈值是多少？
第五步：列出AI最常犯的3个错 → 比如：自动生成 class 组件、用 any 类型、把逻辑写进 .vue 模板里。
这5个答案，就是你规则文件的唯一骨架。漏掉任何一个，规则就容易空泛失效。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
按模块化块组织内容
不要写成一段话，比如：“请遵守分层架构，避免耦合，同时注意命名规范……”。AI看不懂这种描述。
✅ 正确写法是用 Markdown 列表，每行一条命令式、可执行的约束：
- Use layered architecture: domain → service → infra
- Do not access database outside repository layer
- Component files must use PascalCase (e.g., UserProfile.tsx)
- All API handlers must return Result<T, E> from neverthrow
每条规则必须满足：短（≤15字）、确定（不含“尽量”“建议”）、可执行（AI能立刻照做）。出现“请”“应该”“可以”就删掉重写。
设置规则作用域
方法一：全局生效（始终应用）
适用于“所有回复用中文”“禁止使用 any”这类跨项目通用原则。YAML 头部写：alwaysApply: true
方法二：按文件匹配生效
例如 Vue 组件规范只对 .vue 文件起作用，头部写：
globs: ["**/*.vue"]<br>alwaysApply: false
【globs 必须用英文双引号包裹，且路径通配符语法要严格符合 glob 规范】
方法三：多文件类型联合匹配
如 TypeScript + React 规则同时作用于 .tsx 和 .ts 文件：globs: ["**/*.tsx", "**/*.ts"]
验证规则是否生效
重启 Cursor 编辑器 → 打开任意一个匹配 globs 的文件 → 在聊天框输入 “帮我写一个用户登录函数” → 观察生成代码是否自动遵守你写的规则。
若未生效，立刻检查：
① .cursor/rules/ 路径是否拼写正确（注意是 .cursor，不是 .cursorrules）
② .mdc 文件是否保存（未保存的修改不会加载）
③ globs 模式是否匹配当前文件路径（可用 https://globster.xyz 验证）
