Java 代码规范十条:switch、finally 与集合转换的坑
【摘要】 Java 的复杂度大部分不在语法,而在默认行为与直觉不一致的地方:switch 会穿透、finally 会吞异常、toArray() 会抛类型转换异常。这些点编译器不报错、测试也可能命中不到,只在生产环境偶发。下面十条按「踩中概率 × 排查成本」排序。 1. switch 必须有 default 缺 default 时,枚举新增一个值就会静默走「无分支」路径,返回 null 或...
# Java 代码规范十条:switch、finally 与集合转换的坑
## 一、为什么这十条值得单独记
Java 的复杂度大部分不在语法,而在**默认行为与直觉不一致的地方**:`switch` 会穿透、`finally` 会吞异常、`toArray()` 会抛类型转换异常。这些点编译器不报错、测试也可能命中不到,只在生产环境偶发。下面十条按「踩中概率 × 排查成本」排序。
## 二、结构与流程控制
**1. `switch` 必须有 `default`**
缺 `default` 时,枚举新增一个值就会静默走「无分支」路径,返回 `null` 或保持初值。编译器不会提醒,代码评审也容易放过。
```java
switch (status) {
case ACTIVE: return handle();
case CLOSED: return close();
default: throw new IllegalStateException("unhandled: " + status);
}
```
**2. 非空 `case` 必须以 `break`(或 `return`/`throw`)结束**
穿透(fall-through)在 Java 里是合法语法,但几乎总是 bug。唯一合理场景是多个 case 共用同一段逻辑,此时应显式写成 `case A: case B: ...`。
**3. `if-else if` 链末尾必须有 `else`**
与第 1 条同理:覆盖所有分支,或显式抛出异常。缺失 `else` 等于「其余情况什么都不做」,事故往往就出在这里。
**4. 循环变量不要用浮点数**
`for (double d = 0.0; d != 1.0; d += 0.1)` 会因精度误差永不等于 `1.0`,形成死循环。需要小数步进时用整数索引换算:
```java
for (int i = 0; i <= 10; i++) {
double d = i / 10.0;
}
```
## 三、面向对象与集合
**5. 覆写必须显式 `@Override`**
没有注解时,参数列表写错就变成「新增重载」而非覆写,父类逻辑继续生效,行为诡异且难以发现。
**6. 分清「覆写」与「隐藏」**
同名**实例**方法 → 覆写(Override,多态生效);同名**静态**方法或属性 → 隐藏(Hide,按引用类型决定)。把静态方法当多态用,是典型的隐性 bug。
**7. 集合转数组用 `toArray(T[] a)`**
```java
String[] arr = list.toArray(new String[0]); // 推荐
String[] bad = (String[]) list.toArray(); // 可能 ClassCastException
```
无参 `toArray()` 返回 `Object[]`,强转成具体类型数组在运行时才会失败。
**8. 作为 `HashMap` key 的对象不要可变**
对象的 `hashCode` 依赖的字段一旦被修改,`get/remove` 就找不到原位置——桶位置已变。不可变类(`String`、`Integer`、记录类)是安全的 key。
## 四、异常与并发
**9. 严禁在 `finally` 中 `return`/`break`/`continue`**
`finally` 里的 `return` 会覆盖 `try` 中的返回值,并**吞掉正在抛出的异常**:
```java
try {
throw new IOException("disk full");
} finally {
return; // 异常被静默丢弃,调用方看到的是「正常返回」
}
```
同理,`lock.unlock()` 应放在 `finally`,但 `finally` 里不应有控制流语句。
**10. 启动线程用 `start()`,不用 `run()`**
```java
Thread t = new Thread(task, "worker-1");
t.start(); // 真正并发
// t.run(); // 只是当前线程里同步调用,等于没开线程
```
另外 `ReentrantLock` 相比 `synchronized` 提供了可中断获取、超时获取与公平锁,能显著降低死锁概率,但必须在 `finally` 中释放。
## 五、把规范落成检查
光靠记忆不够,两条低成本手段:
```bash
# 1) 编译期静态检查(示例:接入 Checkstyle 后跑一次)
mvn -q checkstyle:check
# 2) 单测覆盖边界:为每个 switch 增加「未知枚举值」用例
mvn -q -Dtest=StatusSwitchTest test
```
如果团队已有 CI,把这两步放进 PR 门禁,比代码评审口头提醒有效得多。
## 六、代价与不适用
- **代价一:`default` 抛异常会让「未知值」从静默变成崩溃**。对灰度期新增枚举值不友好的系统,应改为记录告警并走保守分支,而不是直接抛。
- **代价二:`@Override` 与格式检查会增加改动量**,老项目批量接入会产生大量机械 diff,建议按模块逐步推进。
- **代价三:`toArray(new String[0])` 每次都新建数组**,热点路径可传入复用数组,但这是优化项而非规范项。
- **不适用**:一次性脚本、教学示例代码,强推全套规范只会拖慢交付;规范应作用于长期维护的生产代码。
## 七、验收清单
1. 所有 `switch` 都有 `default`,且非空分支都以 `break`/`return`/`throw` 结束;
2. `if-else if` 链末尾均有 `else`;
3. 全仓库无「浮点循环变量」;
4. 集合转数组全部使用 `toArray(T[] a)`;
5. 全仓库 `finally` 块内无 `return`/`break`/`continue`;
6. CI 中静态检查与边界单测为必过项。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)