Python 3.6+ 支持在数字字面量中任意合法位置使用下划线提升可读性,解析时直接忽略,与无下划线形式完全等价;Java 7+ 和 ES2021 也支持但规则更严,需注意版本兼容性及非法位置(如开头、结尾、紧邻小数点或进制前缀)引发的语法错误。

Python 3.6+ 中用下划线分隔大数字字面量
Python 支持在数字字面量中任意位置插入下划线 _,只要不挨着小数点、进制前缀或开头/结尾即可。这不是语法糖的“显示效果”,而是解析时直接忽略下划线——1_000_000 和 1000000 完全等价,类型、值、内存布局都一样。
常见错误是把下划线放在非法位置,比如:123_.45(紧贴小数点)、0x_a1(紧贴 0x)、_123 或 123_(开头或结尾)。这些都会触发 SyntaxError: invalid decimal literal。
-
1_000_000✅ 千万级整数,比1000000更易扫读 -
3.141_592_653_589✅ 浮点数按四位分组,匹配 π 常见记忆方式 -
0xFF_FF_FF✅ RGB 颜色值,比0xFFFFFF更直观 -
1_000_000_000_000✅ 避免数错零,尤其在配置超时毫秒或内存字节数时
Java 7+ 的 _ 限制更严格
Java 允许下划线,但规则比 Python 多:不能连续出现、不能在开头/结尾、不能紧邻小数点或 F/L 后缀,且十六进制中不能出现在 0x 后立即跟 _。写错会报 error: illegal underscore。
实际编码中容易踩坑的是浮点后缀场景:1_000_000.0f 合法,但 1_000_000_.0f 或 1_000_000.0_f 都非法。另外,0x1_A 是合法的(0x 后第一个字符是数字),但 0x_A 不行(0x 后直接是 _)。
- 推荐写法:
long fileSize = 2_147_483_647L; - 避免写法:
int x = _100;、double y = 3._14;、int z = 0x__FF; - 注意:JDK 7 引入该特性,旧版编译器(如 JDK 6)会直接报错,CI 环境需确认 JDK 版本
JavaScript 不支持数字字面量下划线
ES2021(ECMAScript 2021)才正式加入 _ 支持,但 Node.js 12.20+ / Chrome 88+ 才稳定可用。低于此版本会解析失败,抛出 SyntaxError: Invalid or unexpected token。
这意味着你不能无脑替换已有代码中的大数字。例如,把 const timeout = 30000; 改成 const timeout = 30_000; 后,若某台生产服务器跑的是 Node.js 10.x,服务启动就会崩。
- 检查运行时版本最简单的方法是执行
process.version(Node.js)或navigator.userAgent(浏览器) - 构建时可借助 Babel 插件
@babel/plugin-proposal-numeric-separator转译,但需确保目标环境仍能正确处理数值精度(尤其是Number.MAX_SAFE_INTEGER以上) - 替代方案:用常量名表达意图,比如
const THIRTY_SECONDS_MS = 30_000;(如果环境支持),否则退回到注释说明// 30 seconds in ms
下划线不影响计算,但会影响字符串化和调试体验
所有语言中,下划线只存在于源码层面,编译/解释后完全消失。所以 print(1_000_000) 输出仍是 1000000,JSON.stringify({size: 1_073_741_824}) 得到 {"size":1073741824}。
这点容易被忽略:你在 IDE 里看着舒服,但日志、API 响应、调试器变量面板里不会显示下划线。如果团队依赖日志里的数字做快速识别(比如一眼认出 1073741824 是 1GiB),那光靠下划线没用,还得配合单位注释或常量命名。
- 调试时别指望
console.log(0b11_1111_1111_1111_1111_1111)在控制台显示带下划线——它只会输出十进制4194303 - 二进制/八进制字面量加下划线很实用,但注意 Python 中
0b11_00合法,而0b_1100非法;Java 中0b1010_1010合法,0b1010__1010非法(双下划线) - 真正提升可读性的不是下划线本身,而是你是否统一了分组逻辑(比如总是千分位、总是每 4 位、还是按字节对齐)

















