掌握cursor rules核心结构可快速写出可用规则:每条规则以rule开头并用大括号包裹,必须包含when和then块;支持通过language字段限定语言生效,且需重启cursor加载新规则。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

刚接触Cursor Rules时,很多人卡在规则语法写错导致AI不按预期执行指令,其实只要掌握核心结构和几个关键符号的用法,就能快速写出可用规则。
先搞懂Rules的基本结构
每条Rules必须以rule开头,后面紧跟一对大括号{},所有内容都得写在里面,漏掉任何一个符号都会让整条规则失效。
【大括号必须成对出现,且不能嵌套其他大括号】
规则里至少要包含when(触发条件)和then(执行动作)两个块,中间用冒号分隔,缺一不可。
写第一条简单规则:自动补全函数注释
方法一:用内置模板快速生成
在Cursor编辑器中新建文件 → 文件名输入.cursor/rules.ts → 按回车 → 系统会自动生成基础规则框架。
方法二:手动写最简可用规则
打开.cursor/rules.ts → 在rule大括号内写:when: { text: "function" }, then: { insert: "/**\n * @param \n * @returns \n */" }。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进,以实现更好的上下文管理,并在编辑器和 CLI 中带来了许多提升使用体验的修复。
这一步操作起来很简单,直接把上面那行粘贴进去就行,但注意text匹配的是光标前最近的单词,不是整行内容。
让规则只在特定语言生效
第一步:找到当前文件的语言ID
按下Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(Mac)→ 输入“Developer: Inspect Editor Tokens and Scopes” → 回车 → 查看右下角显示的languageId值,比如typescript或python。
第二步:把语言限制加进when条件
修改规则中的when块:when: { text: "function", language: "typescript" }。
第三步:保存文件并重启Cursor
【不重启的话新规则不会加载】
重启后,在TypeScript文件里输入function再按空格,注释模板才会自动弹出。










