Java双精度浮点数%f格式化的舍入精度差异问题

双精度浮点数无法精确表示部分十进制小数，我们来看两个具体案例：

• 十进制数0.20000000000000029对应的双精度实际值为0.20000000000000028865798640254070051014423370361328125，二进制表示为0011111111001001100110011001100110011001100110011001100110100100
• 十进制数0.3213213214213222219对应的双精度实际值为0.321321321421322247946505967775010503828525543212890625，二进制表示为0011111111010100100100001000011101001101110000001100010111111001

运行以下Java代码：

class Main {
    public static void main(String[] args) {
        double x = 0.2000000000000002900;
        double y = 0.3213213214213222219;
        System.out.printf("x = %.20f , y = %.20f%n", x, y);
    }
}

输出结果为：

x = 0.20000000000000030000 , y = 0.32132132142132225000

观察输出可以发现，x的输出是实际值舍入到16位有效数字的结果，y的输出则是舍入到17位有效数字的结果，为什么二者的舍入精度会不一致？

原因解析 #

这是因为Java的printf处理双精度浮点数格式化时，遵循最短十进制表示规则，结合指定小数位数进行舍入，而非固定使用某一精度。

• 双精度的有效数字特性：double是64位二进制浮点数，对应的十进制有效数字范围在15-17位之间——不同的二进制浮点数转十进制时，所需的最短唯一表示长度会有差异。
• 最短表示的必要性：输出的十进制数必须能唯一映射回原双精度值，避免和相邻的浮点数混淆：
  • 对于x的实际值，16位有效数字0.2000000000000003已经能唯一对应到原双精度值，再缩短就会指向其他值，因此舍入后显示为0.20000000000000030000。
  • 对于y的实际值，需要17位有效数字0.32132132142132225才能唯一确定原双精度值，若只取16位会和其他浮点数冲突，因此格式化时保留到17位，最终显示为0.32132132142132225000。
• %.20f的作用：这个格式指定的是输出20位小数，而非固定有效数字位数。当有效数字不足20位时会用0补全，但核心是优先保证输出能唯一对应原浮点数，因此不同值的舍入精度看起来不一致。

内容的提问来源于stack exchange，提问作者İlker Deveci