Cursor Rules 不生效，通常不是 Cursor 没读取，而是规则类型、路径范围或触发方式没配对。先看你的规则是 Always、Auto Attached、Agent Requested 还是 Manual，再看文件是不是放在 .cursor/rules 里。
先分清四类规则
Always 是每次都带上，适合非常短的全局约定，比如“回答前先看现有实现”。Auto Attached 需要匹配文件路径，适合前端、后端、测试目录分别套规则。Agent Requested 需要清楚描述，让 Agent 判断是否调用。Manual 则必须你在对话里显式提到规则名。
很多人把规则写成 Manual，却以为它会自动生效；或者写了 Auto Attached，但 globs 没匹配当前文件，自然看起来像没用。
路径位置也很关键
项目规则应放在 .cursor/rules 下。子目录也可以有自己的规则目录，用来给某一块代码加局部约束。老的 .cursorrules 还能用，但更推荐迁到 Project Rules，因为它能控制范围和触发方式。
如果你把规则放在普通文档目录里，Cursor 不会自动把它当规则。要么通过规则系统创建，要么在聊天里用 @ 引用具体文件。
怎么快速验证
新建一条很短的 Always 规则，要求 Agent 回复计划时必须先列“将读取哪些文件”。然后开启一个新对话，让它处理小任务。如果它遵守，说明规则系统正常；问题在你的原规则太长、类型不对或路径没匹配。
再检查 Agent 侧边栏里是否显示 Active rules。没显示，基本就是没触发。
写规则别太像愿望清单
“写高质量代码、注意性能、安全可靠”这种规则效果很弱。改成具体动作：“修改前先搜索同名组件；新增接口必须补 Zod schema；不要创建第二套请求封装。”规则越像团队内部开发规范，越容易生效。
结论：Cursor Rules 要按触发方式写，而不是把所有要求塞进一个长文件。先选对类型，再控制路径，最后用小任务验证。
