必须在项目根目录创建.cursur/rules目录并配置含alwaysApply:true的frontmatter规则文件，才能让Cursor AI自动遵守目录结构、命名习惯和编码风格。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让Cursor AI在生成代码时自动遵守你项目的目录结构、命名习惯和编码风格，而不是每次都要手动提醒它“用snake_case”“别新增依赖”，就得配置项目级Rules文件。
创建项目规则目录
在你的项目根目录下执行命令：mkdir -p .cursor/rules。这一步必须做，否则Cursor不会识别项目规则——【.cursor/rules 是唯一被识别为项目规则的路径】。
确认目录已创建：进入项目根目录后，运行 ls -a | grep cursor，应能看到 .cursor 文件夹。
新建一个全局生效的规则文件
在 .cursor/rules/ 目录中新建一个文件，例如 project-standards.mdc。
打开该文件，第一行必须写 frontmatter 头部：
---description: 项目通用代码规范与 Agent 输出规范alwaysApply: true---
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
这个头部不是可选的——缺少 alwaysApply: true，规则就不会在所有对话中自动生效；没有 --- 包裹，Cursor 会直接忽略整个文件。
写入具体可执行的规范
在 frontmatter 下方空一行，开始写正文规则。不要写“尽量”“建议”这类模糊词，AI 无法执行。
比如 Python 项目，这样写才有效：
## Python代码规范
- 函数名全部用 snake_case（如 parse_user_input）
- 类名必须 PascalCase（如 UserProfileService）
- 所有函数必须带类型注解，无例外
- 每个函数长度 ≤ 15 行，超长必须拆分
- 异常必须显式抛出或记录，禁止 silent catch
再比如前端项目，可以加一条硬约束：
## 组件规范
- Vue 组件必须使用 <script setup> 语法
- 样式只允许 SCSS，禁止内联 style 或 CSS Modules
- 所有 props 必须声明类型，使用 defineProps 显式定义
验证规则是否生效
重启 Cursor（关闭再打开），或在任意代码文件中右键 → “Ask Cursor” → 输入：“帮我写一个用户登录校验函数”。
观察返回结果：如果函数名是 validate_login 而不是 validateLogin，且用了类型注解、没引入新库、没写 console.log，说明规则已生效。
若未生效，检查三处：【文件路径是否为 .cursor/rules/xxx.mdc】、frontmatter 是否完整、文件编码是否为 UTF-8（BOM 会导致解析失败）。
