[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 (必读)
- 【字符串解析】不认【下划线】。实测
Integer.parseInt("1_000")和new BigDecimal("1_000")都抛NumberFormatException——【下划线】只属于源码的字面量,配置文件、接口参数、JSON 里的数字不能带。 - 不要滥用成【装饰】。分组应与阅读习惯对齐(3 位或 4 位),
1__2、1_2_3_4_5这类写法会降低可读性;团队内建议固定一条约定(例如「十进制 3 位分组、二进制/十六进制 4 位分组」)。 - 【老项目】看【编译级别】。源码级别低于 7(如
-source 1.6)会直接报非法字符: '\u005f',这类【历史工程】升级 JDK 时偶见。
Y 推荐文献
X 参考文献
本文作者:
千千寰宇
本文链接: https://www.cnblogs.com/johnnyzen
关于博文:评论和私信会在第一时间回复,或直接私信我。
版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!
日常交流:大数据与软件开发-QQ交流群: 774386015 【入群二维码】参见左下角。您的支持、鼓励是博主技术写作的重要动力!
本文链接: https://www.cnblogs.com/johnnyzen
关于博文:评论和私信会在第一时间回复,或直接私信我。
版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!
日常交流:大数据与软件开发-QQ交流群: 774386015 【入群二维码】参见左下角。您的支持、鼓励是博主技术写作的重要动力!

浙公网安备 33010602011771号