[JDK/Java SE] Java 数字字面量-支持下划线 [JDK7-]

0 序

  • 看到项目的代码中有 Java 的 30_000L (才发现,不知道从何时起,Java 已支持 数字中使用 _ 下划线)。
private static final long RETRY_DELAY_MILLIS = 30_000L;

核心结论 (必读)

  • 30_000L 能成立,是因为 Java 7 起【数字字面量】允许在数字之间插入【下划线】做【视觉分组】。

它严格说不算语法糖——不是“编译器帮你展开成别的代码”,而是【词法分析阶段】直接丢弃【分隔符】,编译出的字节码与 30000L 逐位相同,【运行时】——【零开销】。

项目 内容
引入版本 Java 7(2011-07,JLS §3.10.1 数字字面量)
出处 同批「小语言改动」Project Coin(JSR 334),与二进制字面量 0b、钻石操作符 <>、try-with-resources、multi-catch 一起发布
生效层 仅源码词法层;常量池/字节码中无下划线痕迹
后续变化 Java 9 起单个 _ 成为关键字,不能再作【标识符】(javac 报「'_' 为关键字,不能用作标识符」)

1 Java 数字字面量-支持下划线

使用规则:本质只有一条 (必读)

【下划线】只能夹在两个数字之间(数字 _ 数字),其他任何位置都不行。

下表为 javac 17 实测(✅ 编译通过 / ❌ 编译失败):

写法 结果 说明
30_000、30_000L、1_2_3 ✅ 十进制任意分组
1__2 ✅ 允许连续多个下划线(不推荐,语义模糊)
0x30_00、0b1010_1010、010_000、0_10 ✅ 十六/二/八进制内部同样可用
1_000.000_1、1.0e1_0 ✅ 小数位与指数位都能分组
1234_5678_9012_3456L、9223372036854775807L ✅ 长整型常量易读写法
0x_30、0b_1010 ❌ 紧跟进制前缀 0x/0b 之后
3_.14、3._14 ❌ 紧邻小数点
1_e10、1e_10 ❌ 紧邻指数符 e(e 不是数字)
30_、1_、30_L ❌ 结尾位置,或紧贴 L/f/d 后缀
_30 ❌ 解析为标识符而非数字,报「找不到符号」

典型用法

public class LiteralDemo {
    // 1. 时间常量:30_000L 一眼读作 30 秒,而不是数一堆 0
    private static final long TIMEOUT_MS   = 30_000L;      // 30s
    private static final long RETENTION_MS = 86_400_000L;  // 1d

    // 2. 位掩码 / 权限位:4 位一组按二进制对齐
    private static final int MASK_ALL   = 0b1111_1111_1111_1111;

    // 3. 金额、额度、卡号类常量,按业务习惯分组(分 → 元)
    private static final long MAX_CREDIT = 100_000_000L;   // 1 亿元(单位:分)

    // 4. 颜色值、身份证/手机号等以数字出现的展示型常量
    private static final int BRAND_BLUE = 0x1E_6F_EB;
}

坑x3 (必读)

  1. 【字符串解析】不认【下划线】。实测 Integer.parseInt("1_000") 和 new BigDecimal("1_000") 都抛 NumberFormatException——【下划线】只属于源码的字面量,配置文件、接口参数、JSON 里的数字不能带。
  2. 不要滥用成【装饰】。分组应与阅读习惯对齐(3 位或 4 位),1__2、1_2_3_4_5 这类写法会降低可读性;团队内建议固定一条约定(例如「十进制 3 位分组、二进制/十六进制 4 位分组」)。
  3. 【老项目】看【编译级别】。源码级别低于 7(如 -source 1.6)会直接报 非法字符: '\u005f',这类【历史工程】升级 JDK 时偶见。

Y 推荐文献

X 参考文献

posted @ 2026-11-09 17:45  千千寰宇  阅读(8)  评论(0)    收藏  举报