number_format仅支持千位分隔与固定小数位，不支持货币、科学计数、前导零或本地化；传字符串需先清洗再转float，参数顺序和类型易出错，返回字符串不可直接参与计算。
直接说结论：不是万能数字格式化函数，它只处理“千位分隔”和小数位数，不支持货币符号、科学计数、前导零或本地化（如中文“万/亿”）——用错场景会出奇怪的或截断精度。
为什么
传字符串会报错？
它底层强制把第一个参数转成 float，但 PHP 的 float 对超长数字（比如 16 位以上整数）会丢失精度，更关键的是：如果输入是带逗号、空格或单位的字符串（如
或
），PHP 不会自动清理，直接抛
并返回 false。
必须先用
或正则
清洗
清洗后建议再用
或
显式转换，避免隐式转换行为不一致
注意：
会丢小数，别混用
的四个参数到底怎么配？
它的签名是
。最容易踩的坑是参数顺序和类型——第 2 个参数不是“保留几位小数”，而是“强制固定几位小数”；如果设为 0，
会变成
（小数部分被砍掉，不是四舍五入）。
要保留原小数位数？得先用
/
控制精度，再传给
想用中文逗号做千分位？把第 4 个参数设成
（全角），但注意 UTF-8 环境下确保页面编码一致，否则显示乱码
第 2、3、4 参数必须同时出现才能省略前面的——不能只写
然后期望用中文分隔符，必须写全四个参数
替代方案：什么时候不该用
？
它本质是“字符串拼接工具”，不是格式化引擎。遇到这些情况，换别的方法更稳：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记（深入）
”；
要加货币符号？用
或
（已废弃，慎用）
要处理大整数（如 ID、金额超 2^53）？改用
/
配合字符串操作
要本地化（如法语小数点变逗号、千分位变空格）？上
类：
要格式化百分比？别套
，先
再拼，否则浮点误差可能让
变成
最常被忽略的一点：
返回的是字符串，不是数字。后续如果拿结果去计算（比如
），PHP 会尝试转成 float，但此时
被转成
（从左读到第一个非法字符为止）。真要算，得先
。
number_formatWarning: number_format() expects parameter 1 to be float, string givennumber_format"1,234.56""1234.56元"Warningfilter_var($str, FILTER_SANITIZE_NUMBER_FLOAT, FILTER_FLAG_ALLOW_FRACTION)preg_replace('/[^\d.-]/', '', $str)floatval()(float)intval()number_formatnumber_format(float $num, int $decimals = 0, string $decimal_separator = '.', string $thousands_separator = ',')1234.56"1,234"floor()round()number_format'，'number_format($n, 2)number_formatsprintf('¥%.2f', $amount)money_format()bcadd()bcscale()NumberFormatter$fmt = new NumberFormatter('fr_FR', NumberFormatter::DECIMAL); $fmt->format(1234.56);number_format($p * 100, 1) . '%'round($p * 100, 1)0.125 * 10012.499999999999999number_format$a = number_format(1234.56, 2); $b = $a + 1;"1,234.56"1.0str_replace(',', '', $a)