number_format仅支持千位分隔与固定小数位，不支持货币、科学计数、前导零或本地化；传字符串需先清洗再转float，参数顺序和类型易出错，返回字符串不可直接参与计算。
直接说结论：number_format 不是万能数字格式化函数，它只处理“千位分隔”和小数位数，不支持货币符号、科学计数、前导零或本地化（如中文“万/亿”）——用错场景会出奇怪的 Warning: number_format() expects parameter 1 to be float, string given 或截断精度。
为什么 number_format 传字符串会报错？
它底层强制把第一个参数转成 float，但 PHP 的 float 对超长数字（比如 16 位以上整数）会丢失精度，更关键的是：如果输入是带逗号、空格或单位的字符串（如 "1,234.56" 或 "1234.56元"），PHP 不会自动清理，直接抛 Warning 并返回 false。
- 必须先用
filter_var($str, FILTER_SANITIZE_NUMBER_FLOAT, FILTER_FLAG_ALLOW_FRACTION)或正则preg_replace('/[^\d.-]/', '', $str)清洗 - 清洗后建议再用
floatval()或(float)显式转换，避免隐式转换行为不一致 - 注意：
intval()会丢小数，别混用
number_format 的四个参数到底怎么配？
它的签名是 number_format(float $num, int $decimals = 0, string $decimal_separator = '.', string $thousands_separator = ',')。最容易踩的坑是参数顺序和类型——第 2 个参数不是“保留几位小数”，而是“强制固定几位小数”；如果设为 0，1234.56 会变成 "1,234"（小数部分被砍掉，不是四舍五入）。
- 要保留原小数位数？得先用
floor()/round()控制精度，再传给number_format - 想用中文逗号做千分位？把第 4 个参数设成
'，'（全角），但注意 UTF-8 环境下确保页面编码一致，否则显示乱码 - 第 2、3、4 参数必须同时出现才能省略前面的——不能只写
number_format($n, 2)然后期望用中文分隔符，必须写全四个参数
替代方案：什么时候不该用 number_format？
它本质是“字符串拼接工具”，不是格式化引擎。遇到这些情况，换别的方法更稳：
立即学习“PHP免费学习笔记（深入）”；
- 要加货币符号？用
sprintf('¥%.2f', $amount)或money_format()（已废弃，慎用） - 要处理大整数（如 ID、金额超 2^53）？改用
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 * 100变成12.499999999999999
最常被忽略的一点：number_format 返回的是字符串，不是数字。后续如果拿结果去计算（比如 $a = number_format(1234.56, 2); $b = $a + 1;），PHP 会尝试转成 float，但此时 "1,234.56" 被转成 1.0（从左读到第一个非法字符为止）。真要算，得先 str_replace(',', '', $a)。
