Alibaba Java Development Guidelines Skill (嵩山版)

在任何 Java 代码的编写、修改、审查场景中，必须严格遵守本规范。 规约等级：【强制】>【推荐】>【参考】

适用范围

本 skill 在以下场景中自动激活并强制执行：

• 编写新的 Java 类 / 接口 / 枚举
• 修改已有的 Java 代码
• 代码审查 / Code Review
• 重构代码
• 生成 SQL / MyBatis XML 映射
• 设计数据库表结构
• 编写单元测试
• 定义 API 接口（前后端交互）

核心工作流程

Step 1: 规则匹配

根据当前代码任务，定位适用的规约分类：

Step 2: 读取对应规约文件

在生成/修改代码之前，必须读取对应 reference 文件，逐条对照【强制】规则。

Step 3: 生成/修改代码

按照规约要求编写代码，注意：

• 【强制】规则 必须遵守，无例外
• 【推荐】规则 应尽量遵守
• 【参考】规则 可酌情采纳

Step 4: 自查清单

代码生成后，逐项对照以下通用自查（适用于所有 Java 代码任务）：

命名

• 类名 UpperCamelCase，方法/变量 lowerCamelCase
• 常量全大写 + 下划线分隔
• 包名全小写，单数形式
• 无拼音、无下划线开头/结尾、无歧视性词语
• POJO 布尔变量不加 is 前缀
• 枚举类带 Enum 后缀，成员全大写

代码格式

• 4 空格缩进，无 Tab
• 单行 ≤ 120 字符
• 关键词与括号间有空格，运算符左右有空格
• UTF-8 编码，Unix 换行符

OOP

• 覆写方法加了 @Override
• equals 用常量/确定值调用，整型包装类用 equals 比较
• 浮点数用 BigDecimal 比较，BigDecimal 用 compareTo
• POJO 属性用包装类型，不设默认值
• POJO 有 toString
• 构造方法无业务逻辑

集合

• 覆写 equals 时覆写了 hashCode
• isEmpty() 判空而非 size()==0
• Collectors.toMap() 使用了 mergeFunction
• foreach 中无 remove/add 操作
• 集合初始化指定大小

并发

• 线程通过线程池创建，不用 Executors
• SimpleDateFormat 非 static 或用 ThreadLocal
• ThreadLocal 在 finally 中 remove()
• 锁在 try 外获取，finally 中释放

控制语句

• switch 有 default，每个 case 有 break/return
• if/else/for/while 使用大括号
• 三目运算符注意自动拆箱 NPE

异常日志

• 不用 catch 预检可规避的 RuntimeException
• 异常不捕获后抛弃，要处理或上抛
• finally 中不使用 return
• RPC/二方包用 Throwable 拦截
• 日志用 SLF4J，占位符拼接，有级别开关
• 生产环境无 System.out / e.printStackTrace()

MySQL

• 不用 SELECT *
• 主键 bigint unsigned 自增，必备字段 id, create_time, update_time
• 小数用 decimal，不用 float/double
• 无外键、无存储过程
• MyBatis 用 #{} 不用 ${}

安全

• SQL 参数绑定，无字符串拼接
• 用户输入参数校验
• 敏感数据脱敏
• CSRF 防护

快速规则速查

命名速查

类名:       UpperCamelCase   (例外: DO/DTO/VO/BO/AO/PO/UID)
方法/变量:  lowerCamelCase
常量:       ALL_UPPER_CASE
包名:       alllowercase.singular
数组:       int[] array      (不是 String args[])
枚举:       XxxEnum.SOME_VALUE
抽象类:     AbstractXxx / BaseXxx
异常类:     XxxException
测试类:     XxxTest
Service:    XxxService (接口) / XxxServiceImpl (实现)

代码格式速查

缩进:       4 空格，禁止 Tab
行宽:       ≤ 120 字符
空格:       if/for/while + 空格 + (
           运算符左右各一空格
           注释 // 后一空格
括号:       左大括号前空格，不换行
编码:       UTF-8，Unix 换行

常见陷阱速查

参考文件

完整规约来源: D:\ai\Java开发手册（嵩山版）.md

版本