跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言AI大前端java

Cursor Rules 配置参考:前后端 Golang/TypeScript/Kotlin 开发规范

适用于 Cursor 编辑器的规则配置文件,涵盖后端(Golang/Java)、前端(TypeScript+React/Vue)及 Android(Kotlin/Java)场景。内容包含通用规则、自动化执行与安全策略、代码质量优化、架构感知及变更可追溯性等方面,旨在提升开发效率与准确性。

机器人发布于 2026/3/29更新于 2026/10/23102 浏览
Cursor Rules 配置参考:前后端 Golang/TypeScript/Kotlin 开发规范

【Cursor 开发中 rules 配置文件】后端版(适配 Golang/Java 场景)

通用规则
  1. 默认情况下,所有回复都必须是中文,而且需要在开头称呼用户为'帅哥:'
  2. 复杂需求拆解成小任务,分步实现,每完成一个小任务后再继续
  3. 代码实现前后要仔细检查,确保没有遗漏
  4. 在已有功能基础上添加新功能时,必须确保:
    • 不影响原有功能
    • 不添加其他功能、代码、逻辑、文件、配置、依赖
  5. 遵循架构设计,保持代码风格一致
  6. 代码修改遵循单一职责原则,不混合多个变更
  7. 在进行代码设计规划的时候,请符合'第一性原理'
  8. 在代码实现的时候,请符合'KISS 原则'和'SOLID 原则'
  9. 尽量复用已有代码,避免重复代码
  10. 不引入不必要的依赖,避免增加维护成本
  11. 确保代码可读性与可维护性,必要时加简要注释
  12. 代码变更范围最小化,避免大范围修改
  13. 实现后进行基本逻辑自检,确保无错误
  14. 如果有疑问,先询问再修改,不要擅自做决定
自动化执行与安全策略
  1. 自动执行无需严格确认的操作,减少人为干预,提高执行效率:
    • 自动执行编译、验证等必要流程
    • 删除、移动、重命名文件等常规操作无需额外确认
    • 命令行操作中,非关键性指令(如清理缓存、构建项目)可直接执行
    • 涉及影响较大的操作(如覆盖文件、修改数据库结构)仍需确认
  2. 重要操作(如文件删除、数据库修改)应自动备份,避免误操作
  3. 涉及数据库变更的操作,优先生成 SQL 变更脚本,而非直接执行
  4. 执行高风险操作前,AI 代码编辑器应自动检测影响范围,必要时提供提示
代码质量优化
  1. 代码生成后,自动进行基本优化(如去除未使用的 import、合并重复代码)
  2. 对于可能影响性能的代码(如 SQL 查询、循环嵌套),提供优化建议
  3. 关键功能应提供异常处理机制,避免程序崩溃
架构感知
  1. AI 代码编辑器应优先分析现有代码库,避免重复实现已有功能
  2. 在添加新功能时,优先复用已有模块,而非从零编写
  3. 如遇架构不清晰的情况,先整理依赖关系,再执行修改
代码变更的可追溯性
  1. 所有代码变更应附带清晰的 commit 信息,描述修改点和原因
  2. 对于影响较大的改动(如架构调整),可自动生成变更日志
  3. 如涉及 API 变更,应提供新旧版本兼容策略
  4. AI 代码编辑器在执行任务前,必须先读取「业务架构文档」和「最新变更记录」,确保逻辑一致性
  5. 每次代码修改后,AI 必须自动生成「任务总结」,描述修改逻辑并更新变更记录
  6. 我们手动维护这些文档,并在 AI 执行任务前提供,确保长期架构记忆

【Cursor 开发中 rules 配置文件】前端版(适配 TS+Vue/React 场景)

通用规则
  1. 默认情况下,所有回复都必须是中文,而且需要在开头称呼用户为'帅哥:'
  2. 复杂需求拆解成小任务,分步实现,每完成一个小任务后再继续
  3. 代码实现前后要仔细检查,确保类型定义完整、组件 props 正确
  4. 在已有功能基础上添加新功能时,必须确保:
    • 不影响原有功能和组件复用性
    • 不添加其他功能、代码、逻辑、文件、配置、依赖
  5. 遵循项目架构设计,保持代码风格与 TypeScript/ESLint 规范一致
  6. 组件设计遵循单一职责原则,不混合多个变更
  7. 在进行组件设计规划时,符合'第一性原理'
  8. 在代码实现时,符合'KISS 原则'和'SOLID 原则'
  9. 优先使用现有组件库和 hooks,避免重复代码
  10. 不引入不必要的依赖,优先使用项目已有库
  • 确保代码可读性,复杂逻辑添加注释,组件 props 类型详细定义
  • 代码变更范围最小化,避免修改公共组件、全局状态
  • 实现后进行基本逻辑自检,确保状态管理与生命周期正确
  • 如有疑问,先询问再修改,不要擅自改变组件 API 设计
  • 自动化执行与安全策略
    1. 自动执行无需严格确认的操作,提高效率:
      • 自动执行 TypeScript 类型检查、ESLint 验证
      • 文件操作(创建组件、修改样式文件)无需额外确认
      • 常规命令(如 npm install、启动开发服务器)可直接执行
      • 涉及构建配置、路由修改等重要变更仍需确认
    2. 重要操作(修改全局状态、路由配置)应先保留副本
    3. 涉及 API 接口变更,优先修改 TypeScript 接口定义
    4. 执行影响较大的修改前,自动检测组件依赖关系,分析影响范围
    代码质量优化
    1. 代码生成后,自动优化(移除未使用 imports、合并重复样式)
    2. 对可能影响性能的代码(如不必要的重渲染、大型循环)提供优化建议
    3. 确保异常处理和加载状态管理,防止白屏和渲染错误
    架构感知
    1. 优先分析现有组件库与状态管理模式,避免创建冗余组件
    2. 添加功能时,优先考虑复用 hooks、contexts 或现有组件
    3. 如遇架构不清晰,先梳理组件层次与数据流,再执行修改
    代码变更的可追溯性
    1. 提供清晰的 commit 信息,描述组件变更和影响范围
    2. 对于 UI 组件重大调整,生成变更文档与截图对比
    3. API 或 props 变更时,提供向下兼容方案或迁移指南
    4. 执行任务前,先分析项目结构和组件关系文档
    5. 每次修改后,生成任务总结,说明组件变更和状态管理调整
    6. 手动维护组件文档与设计系统说明,确保长期可维护性

    【Cursor 开发中 rules 配置文件】Android 版(适配 Kotlin/Java 场景)

    通用规则
    1. 默认情况下,所有回复都必须是中文,而且需要在开头称呼用户为'帅哥:'
    2. 复杂需求拆解成小任务,分步实现,每完成一个小任务后再继续
    3. 代码实现前后要仔细检查,确保类型安全、空安全处理完整、生命周期管理正确
    4. 在已有功能基础上添加新功能时,必须确保:
      • 不影响原有功能和组件复用性
      • 不添加其他功能、代码、逻辑、文件、配置、依赖
    5. 遵循项目架构设计,保持代码风格与 Android 编码规范一致(如 Kotlin 风格指南)
    6. 组件设计遵循单一职责原则,不混合多个变更
    7. 在进行组件设计规划时,符合'第一性原理'
    8. 在代码实现时,符合'KISS 原则'和'SOLID 原则'
    9. 优先使用 Android Jetpack 组件库和现有工具类,避免重复代码
    10. 不引入不必要的依赖,优先使用项目已有库
    11. 确保代码可读性,复杂逻辑添加注释,类和接口参数详细定义
    12. 代码变更范围最小化,避免修改公共组件、全局状态
    13. 实现后进行基本逻辑自检,确保生命周期管理和内存泄漏处理正确
    14. 如有疑问,先询问再修改,不要擅自改变组件 API 设计
    自动化执行与安全策略
    1. 自动执行无需严格确认的操作,提高效率:
      • 自动执行 Kotlin 空安全检查、Android Lint 验证
      • 文件操作(创建 Activity、Fragment、修改布局文件)无需额外确认
      • 常规命令(如 Gradle 依赖安装、运行模拟器)可直接执行
      • 涉及 Manifest 配置、权限修改等重要变更仍需确认
    2. 重要操作(修改 Application 类、AndroidManifest.xml)应先保留副本
    3. 涉及 API 接口变更,优先修改数据模型类和接口定义
    4. 执行影响较大的修改前,自动检测组件依赖关系,分析影响范围
    代码质量优化
    1. 代码生成后,自动优化(移除未使用导入、合并重复资源文件)
    2. 对可能影响性能的代码(如主线程阻塞、过度绘制、内存泄漏风险)提供优化建议
    3. 确保异常处理和加载状态管理,防止应用崩溃和 ANR
    架构感知
    1. 优先分析现有架构模式(MVC/MVP/MVVM/Clean Architecture)与依赖注入方式,避免创建冗余组件
    2. 添加功能时,优先考虑复用 ViewModel、Repository 或现有组件
    3. 如遇架构不清晰,先梳理组件层次与数据流,再执行修改
    代码变更的可追溯性
    1. 提供清晰的 commit 信息,描述组件变更和影响范围
    2. 对于 UI 组件重大调整,生成变更文档与截图对比
    3. API 或接口变更时,提供向下兼容方案或迁移指南
    4. 执行任务前,先分析项目结构和组件关系文档
    5. 每次修改后,生成任务总结,说明组件变更和状态管理调整
    6. 手动维护组件文档与架构说明,确保长期可维护性
    Android 开发规则
    1. 严格遵循 Android 生命周期管理,避免内存泄漏和崩溃
    2. 处理好 Activity/Fragment 之间的数据传递,优先使用 ViewModel 共享数据
    3. UI 操作必须在主线程执行,耗时操作放在工作线程
    4. 合理使用协程(Kotlin)或 RxJava(Java)进行异步操作
    5. 注意适配不同屏幕尺寸和系统版本的兼容性问题
    6. 使用 Android Jetpack 组件(如 Navigation、Room、WorkManager)提高开发效率
    7. 遵循 Material Design 设计规范,保持 UI 一致性
    8. 注意权限管理和安全性,特别是涉及敏感数据的操作
    9. 优化应用启动速度和 UI 渲染性能
    10. 合理使用资源文件(strings.xml、colors.xml、styles.xml)提高可维护性

    目录

    1. 【Cursor 开发中 rules 配置文件】后端版(适配 Golang/Java 场景)
    2. 通用规则
    3. 自动化执行与安全策略
    4. 代码质量优化
    5. 架构感知
    6. 代码变更的可追溯性
    7. 【Cursor 开发中 rules 配置文件】前端版(适配 TS+Vue/React 场景)
    8. 通用规则
    9. 自动化执行与安全策略
    10. 代码质量优化
    11. 架构感知
    12. 代码变更的可追溯性
    13. 【Cursor 开发中 rules 配置文件】Android 版(适配 Kotlin/Java 场景)
    14. 通用规则
    15. 自动化执行与安全策略
    16. 代码质量优化
    17. 架构感知
    18. 代码变更的可追溯性
    19. Android 开发规则

    更多推荐文章

    查看全部
    • MySQL 数据类型核心指南:选型、实战与避坑
    • 网文创作新范式:AI 工具与工作流实战指南
    • Python 办公自动化:使用 Pandas 库操作 Excel
    • 回溯算法核心原理与 Java 实现详解
    • MCP Server 案例:Excel 表格一键生成可视化图表 HTML 报告
    • Linux 系统进阶:Git 远程协作与分支管理实战
    • Meta 提出多 token 模型训练新方法,有望提升生成速度与智能性
    • OpenLLaMA 智能文案生成系统构建指南
    • 深度学习神经网络代码修改指南:数据预处理与网络结构调整
    • Linux Shell 运行原理及权限管理详解
    • 大模型面试核心问题解析:Transformer 与训练优化
    • Java 详解:局部变量与成员变量的区别
    • C++ 泛型编程与模板机制详解
    • Spring Cloud 微服务架构与开发实战
    • 9 种常用排序算法总结
    • 大型语言模型 Prompt 工程的核心原则与最佳实践
    • 纯 Web 架构智慧 PACS/RIS 系统技术解析
    • VSCode 远程 SSH 下 Copilot 启用 Claude 及修复 Agent 编辑异常
    • 2024 年主流大模型开源工具与框架精选
    • AI 聊天机器人实战:前端界面构建与生产环境部署

    相关免费在线工具

    • RSA密钥对生成器

      生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

    • Keycode 信息

      查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

    • Escape 与 Native 编解码

      JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

    • Mermaid 预览与可视化编辑

      基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

    • JavaScript / HTML 格式化

      使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

    • JavaScript 压缩与混淆

      Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online