Cursor AI代码生成的模板与规则定制方法

1. 模板基础概念

在Cursor中，模板是预定义的代码片段框架，通过变量占位符实现动态生成。核心结构包括：

• 静态部分：固定代码结构
• 动态变量：使用$var$格式声明，例如：

  def $function_name$($param$):
      return $param$ * 2
  

2. 模板创建步骤

1. 新建模板文件
   • 创建.cursor/templates目录
   • 添加.py（Python）或.js（JavaScript）等后缀的模板文件
2. 定义变量规则
   • 使用{{!规则名}}注释声明约束：

     # {{!regex:^[a-z][a-z0-9_]*$}}  # 变量名必须小写字母开头
     $function_name$ = lambda x: x**2
     

3. 变量类型约束
   • 在文件头部添加类型声明：

     /* {{!type:param:number}} */
     function double($param$) { 
         return $param$ * 2;
     }
     

3. **规则定制方法

（1）正则约束

# {{!regex:^[A-Z][a-zA-Z0-9]{3,}$}}  # 类名必须大写开头且长度>=4
class $ClassName$:
    pass

（2）类型检查

// {{!type:userId:string}}
// {{!type:age:number}}
const $userId$: string = "ID001";
let $age$: number = 25;

（3）值域限定

# {{!range:retry_count:1-5}}
retry_count = $retry_count$  # 允许值:1,2,3,4,5

4. **模板调用示例

（1）激活模板

# 命令行调用指定模板
cursor generate --template=axios_request

（2）交互式填充

// 生成时命令行交互
? Enter API endpoint: /user/profile
? Select method: GET

5. 高级配置

在.cursor/config.yaml中设置全局规则：

templates:
  python:
    naming_rule: "snake_case"
    max_params: 5
  react:
    hooks_required: true

最佳实践：

1. 为不同项目创建独立模板目录
2. 使用{{!require:package_name}}确保依赖声明
3. 复杂模板添加template_demo.md说明文件
4. 通过cursor validate --template进行语法检查

通过分层规则设计，可实现从基础代码片段到完整项目框架的智能生成，显著提升开发效率。