Money\Money 类找不到需检查 autoload 和命名空间；必须用整数 cents 构造，禁用 float；所有运算返回新实例（不可变设计）；多币种需通过 Converter 换算，不可直接加减。
MoneyPHP 安装后 Money\Money 类找不到？检查 autoloader 和命名空间
Composer 安装成功不代表能直接用——常见问题是类没被自动加载，或命名空间写错。执行 composer require moneyphp/money 后，必须确认 vendor/autoload.php 已在入口文件中引入（比如 require 'vendor/autoload.php';），否则所有 Money\* 类都会报 Class not found。
MoneyPHP 的核心类不是 Money，而是 Money\Money（注意大小写和反斜杠）。常见错误写法：new Money(100, 'USD')（缺命名空间）或 use Money;（错，应是 use Money\Money;）。正确引入方式：
use Money\Money;
use Money\Currency;
<p>$money = new Money(10000, new Currency('USD'));为什么不能用 float 构造 Money？整数 cents 是硬性要求
MoneyPHP 强制使用整数表示金额（单位为最小货币单位，如美分），根本原因就是规避 float 的二进制精度问题。传入 19.99 这样的 float 会触发异常：InvalidArgumentException: Amount must be an integer。
立即学习“PHP免费学习笔记（深入）”；
实际开发中容易踩的坑：
- 前端传来的金额字符串（如
"19.99"）需先转成整数分：用round((float)$str * 100)，但要注意浮点中间态风险；更安全的是用bcadd或正则提取数字部分再乘 - 数据库字段类型建议用
INT或BIGINT存 cents，而非DECIMAL(10,2)或FLOAT -
Money::fromString()可解析字符串（如Money::fromString('19.99', new Currency('USD'))），内部已做安全转换，推荐优先使用
Money::add() 和 Money::subtract() 为什么返回新实例而不是修改原对象？
MoneyPHP 是 immutable（不可变）设计，所有运算方法（add、subtract、multiply、divide）都返回全新 Money 实例，原对象不变。这不是 bug，是刻意为之——避免意外共享状态引发精度污染。
典型误用：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
$total = new Money(10000, $usd); $total->add(new Money(5000, $usd)); // ❌ 无效果！返回值被丢弃 echo $total->getAmount(); // 还是 10000
正确写法：
$total = $total->add(new Money(5000, $usd)); // ✅ 赋值回变量 // 或一步到位 $total = (new Money(10000, $usd))->add(new Money(5000, $usd));
注意：multiply() 默认返回整数结果，若需小数位（如汇率换算），必须显式传入 Math\Decimal 实现，否则会截断——这点文档不明显，容易导致换算失真。
多币种计算时 Money::convert() 报错 “Currency mismatch” 怎么办？
Money 实例之间不能直接加减不同币种，这是设计约束，不是限制。想换算，必须用 Converter 接口配合汇率提供器（如 ExchangeRateProvider）。常见错误是试图 $eur->add($usd)，直接抛出 LogicException。
最小可用换算示例（需额外安装 moneyphp/iso-currencies 和汇率数据）：
use Money\Currencies\ISOCurrencies;
use Money\Exchange\Bank;
use Money\Exchange\Exchange;
<p>$currencies = new ISOCurrencies();
$bank = new Bank($currencies);
$bank->addRate('USD', 'EUR', 0.92); // 手动设简单汇率
$converter = new Exchange($bank);</p><p>$usd = Money::fromString('100.00', new Currency('USD'));
$eur = $converter->convert($usd, new Currency('EUR'));生产环境别硬编码汇率——应对接真实汇率 API（如 ECB、Open Exchange Rates），并缓存结果。汇率精度丢失（如只保留 2 位小数）会导致累积误差，建议存储和运算时用至少 6 位小数。
真正麻烦的从来不是“怎么装”，而是“怎么让团队所有人从第一天起就放弃 float + number_format 的直觉写法”。一旦有一个人绕过 Money 直接算，整个链路精度就垮了。
