需在项目根目录创建.cursor/rules文件夹并放置prompt-template.mdc和project-prompt.mdc两个UTF-8编码模板文件,再通过注释指令// @rule: 或设置启用规则,使AI生成代码前严格遵循前端开发规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在Cursor中复用一套稳定、可继承的提示词结构,避免每次写需求都从零组织语言,让AI每次生成代码前先读规则再动手。
创建全局Rules文件夹
打开项目根目录→右键新建文件夹→命名为.cursor→再在该文件夹内新建子文件夹→命名为rules。
【必须严格使用小写字母和英文点号】 文件夹名写成 .cursor/rules,不能是 .Cursor/Rules 或 cursor/rules,否则Cursor无法识别。
编写基础提示词模板文件
进入.cursor/rules目录→新建一个文本文件→命名为prompt-template.mdc→用UTF-8编码保存。
在文件中粘贴以下内容(直接复制,不加引号,不换行):
```
你是一名资深前端工程师,专注React 18 + TypeScript项目开发。
所有输出必须用中文,不加解释、不加emoji、不寒暄。
修改代码前必须先读取上下文中的组件结构和props定义。
禁止引入新依赖,仅使用项目已安装的库。
生成的JSX必须符合现有CSS模块命名规范(BEM风格)。
```
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进,以实现更好的上下文管理,并在编辑器和 CLI 中带来了许多提升使用体验的修复。
这一步操作起来很简单,直接把上面六行文字粘贴进去就行。注意不要多空行、不要漏掉任意一行,否则规则会失效。
配置项目级提示词模板
第一步:在项目根目录下创建.cursor/rules/project-prompt.mdc文件
第二步:填入当前项目特有的约束,例如:
• 所有API调用必须走/src/lib/api/client.ts封装的fetcher
• 表单提交后跳转路径统一为/app/(auth)/dashboard
• 页面级错误边界必须使用@/components/ErrorBoundary
第三步:确保该文件名以.mdc结尾,且文件编码为UTF-8无BOM。
如果项目用了Zustand管理状态,就在这份文件里加一句“状态更新必须通过store.setState(),禁止直接修改store对象属性”。不写这条,AI可能擅自改写store结构,导致运行时报错。
引用模板并生效
方法一:在任意代码文件顶部添加注释指令
// @rule: prompt-template.mdc
// @rule: project-prompt.mdc
方法二:在Cursor设置中启用自动加载
Ctrl/Cmd + , → General → Rules for AI → 勾选“Enable rules from .cursor/rules” → 点击Apply。
方法三:临时注入规则(仅本次请求有效)
在Ctrl/Cmd+K弹出的输入框中,第一行写:
#rule: prompt-template.mdc
然后换行写你的实际需求,例如:“给LoginButton组件添加loading状态和禁用逻辑”。

















