PHP json_encode() 将小数转科学计数法是因 zend_print_double() 的精度逻辑,受 serialize_precision 影响;应使用 round() 控制位数或源头保持字符串,避免 sprintf 后编码导致类型错误。

PHP 默认对大于一定位数的浮点数在 json_encode() 时会转成科学计数法(如 1.23e-4),这不是 JSON 规范问题,而是 PHP 内部对浮点数字符串化时的精度控制逻辑导致的。直接转字符串再编码,反而可能破坏数值语义(比如前端无法当数字用),真正要解决的是「让小数以普通十进制字符串形式输出,同时保持 JSON 中仍是 number 类型」。
为什么 json_encode() 会把小数变科学计数法
PHP 的 json_encode() 调用底层 zend_print_double() 格式化浮点数,当指数绝对值 ≥ 5 或小数位数过多(默认受 serialize_precision 影响)时,就会启用科学计数表示。它和 JSON_UNESCAPED_UNICODE 这类标志无关,是数值到字符串转换阶段就定型了。
-
serialize_precisionini 设置(默认 -1)直接影响浮点转字符串的位数,设为17或-1可缓解但不彻底 - 即使
(string)$float看起来正常,json_encode()仍可能重走自己的格式化路径 - 前端 JS 解析
1.23e-4没问题,但某些强类型系统(如 Go 的json.Unmarshal)或调试工具可能显示异常
推荐做法:用 JSON_PRESERVE_ZERO_FRACTION + 控制输入精度
PHP 7.1+ 提供了 JSON_PRESERVE_ZERO_FRACTION 标志,但它只对「整数但带 .0 后缀」有效(如 42.0 → 42.0),对纯小数无效。真正可控的方式是提前将浮点数四舍五入到合理位数,再交给 json_encode():
- 用
round($val, $precision)显式保留小数位(如round(0.000123456, 6)→0.000123) - 避免用
sprintf('%.6f', $val)后再json_encode(),否则结果是字符串而非 number 类型 - 如果业务要求必须保留全部原始小数位(如金融场景),应改用字符串字段传输,并在 JSON 中明确标记:
{"amount": "123.000000456789"}
绕过 PHP 浮点处理:手动拼接 JSON 字符串(慎用)
仅当上述方法都不满足、且数据结构极简单时可考虑。本质是跳过 json_encode() 的浮点处理逻辑,自己保证小数格式:
立即学习“PHP免费学习笔记(深入)”;
$amount = 0.00000123456789;
$json = '{"amount":' . sprintf('%.12f', $amount) . '}';
// 输出 {"amount":0.000001234568}
- 必须确保
sprintf格式不含多余空格、逗号或引号 - 无法自动转义键名或嵌套数组,一有复杂结构就极易出错
- 若
$amount是INF、NAN或非数值,会直接崩,需额外判断
最易被忽略的一点:PHP 的浮点数本身是二进制近似存储,0.1 + 0.2 !== 0.3。所谓“保存小数”,本质是在精度损失已发生后做展示控制。如果原始数据来自数据库 DECIMAL 或字符串输入,优先从源头保持字符串形态,而不是依赖 PHP 浮点运算后再补救。











