Java 代码规范十条:switch、finally 与集合转换的坑

举报
yd_299686804 发表于 2026/11/10 14:39:55 2026/11/10
【摘要】 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)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。