Cursor Rules怎么配置后端项目规范?

尼克

尼克

2026-07-31

129人浏览

原创

关键在于将项目规范固化进项目根目录的.cursorrules文件,ai每次生成代码时自动读取并遵守:spring boot需统一返回result、service加@transactional、异常全抛出由全局处理器拦截;go项目则限定gin+gorm+zap栈、handler必须用*gin.context、日志用zap、错误调用customerror.new。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

cursor rules怎么配置后端项目规范?

让AI在Java或Go后端项目里写代码时不乱加Lombok、不手动处理异常、不绕过全局拦截器,关键不是反复提醒它,而是把项目规范固化进.cursorrules文件——这个文件一放,AI每次生成都自动读取,不再凭空猜测你的架构意图。

创建项目级规则文件

在项目根目录下新建一个名为.cursorrules的纯文本文件,不要加任何扩展名。这个文件必须放在最外层,和src、pom.xml或go.mod同级,否则AI根本找不到它。

【文件名必须是.cursorrules,不能是.cursorrules.md或.cursorrules.txt】

这一步操作起来很简单,直接在终端执行:touch .cursorrules即可。

写入Spring Boot核心约束

如果你用的是Spring Boot,下面这段规则可以直接复制粘贴进去,它强制AI遵守你项目的实际分层逻辑:

你是一个Java后端开发专家,精通SpringBoot3.x。
项目约束:
所有Controller返回Result统一包装
Service层方法必须标注@Transactional,禁止用SqlSession手动提交
异常全部throw出去,由GlobalExceptionHandler统一拦截处理
数据库逻辑删除字段必须用@TableLogic注解,严禁物理DELETE
RESTful路由严格使用名词复数形式:/users、/orders
数据库字段名用snake_case,Java实体属性用camelCase
禁止在Controller里捕获业务异常并return null或new HashMap()

注意:最后一条“禁止在Controller里捕获业务异常”是关键防线,不写这条,AI大概率会自作主张try-catch再return new Result(),破坏你已有的全局异常流。

Go语言(Golang)1.26.0
Go语言(Golang)1.26.0

Go语言(Golang)1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口,版本号 1.26.0,可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

配置Go后端行为契约

Go项目不需要Spring生态那套,但更需要明确边界。按以下三步写:

第一步:声明AI角色定位
你是一个专注Go微服务的工程师,熟悉Gin+GORM+Zap技术栈。

第二步:定义不可逾越的红线
所有HTTP Handler函数必须接收*gin.Context参数,禁止用net/http原生Handler
数据库操作必须走GORM实例,禁止直接调用database/sql
日志输出必须用zap.Sugar().Info/Error,禁止fmt.Println或log.Printf

第三步:指定结构体字段映射规则
JSON响应字段用json:"user_id"标签,对应数据库列user_id,Go结构体字段命名为UserID
所有错误返回必须调用customError.New("xxx"),该函数已在internal/error包中定义

【第三步中的customError.New必须真实存在,否则AI会虚构函数导致编译失败】

启用规则引擎并验证

打开Cursor设置 → Editor → AI → 勾选Enable Rules Engine,然后重启编辑器。

验证是否生效:在任意Controller里输入“// 生成用户查询接口”,看AI返回的代码是否自动包裹Result.success(...)、是否跳过try-catch、是否用了@GetMapping("/users/{id}")而不是@GetMapping("/user")。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1111

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2132

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2654

10

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1111

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2132

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2654

10

marquee参数有哪些
marquee参数有哪些

marquee参数有direction、behavior、speed、scrolldelay、width、height、bgcolor、cursor、id、align、noresize、nohover、loopcount、bgcolorcolor、scrollamount和vspa。

2023.10.18

578

10

Cursor新手入门教程
Cursor新手入门教程

这是一份为新手量身定制的 Cursor 入门全流程指南。无论你是刚从 VS Code 迁移过来的老手,还是编程小白,这份指南都能帮你快速上手这款“代码自动驾驶仪”。

2026.04.09

49

10

Cursor 核心功能深度解析与实战技巧
Cursor 核心功能深度解析与实战技巧

本专题深度剖析 AI 代码编辑器 Cursor 的核心功能,涵盖 Composer 模式、codebase 索引、实时代码预测(Tab)及 Chat 交互等进阶用法。通过丰富的实战案例,手把手教你如何利用 Cursor 快速构建应用、重构复杂代码及进行自动化 Debug。

2026.04.16

112

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Cursor 使用手册
Cursor 使用手册

共0课时 | 0人学习

Go 官方文档
Go 官方文档

共0课时 | 0人学习