自定义 Twig 函数必须继承 AbstractExtension 并实现 getFunctions() 返回 TwigFunction 实例数组，函数回调须为 [$this, 'methodName'] 形式；formatPrice 等需处理浮点精度与区域设置；推荐自动注册（src/Twig/ 下 App\Tween\ 命名空间类），复杂逻辑应拆至 Service 层。
自定义 Twig 函数必须继承 AbstractExtension，不能直接 new 类
Twig 扩展不是普通服务类，它必须实现 Twig\Extension\ExtensionInterface；Symfony 推荐继承 AbstractExtension，否则会报 TypeError: Expected argument of type "Twig\Extension\ExtensionInterface"。
常见错误是写成普通工具类或静态方法类，然后试图在模板里调用 —— Twig 不识别，也不加载。正确结构必须包含 getFunctions() 方法返回 TwigFunction 实例数组。
-
getFunctions()返回的是Twig\TwigFunction对象，不是字符串或闭包 - 回调必须是
[$this, 'methodName']形式，不能是fn() => ...或静态方法（除非显式绑定） - 函数名（如
'price'）区分大小写，模板中调用时必须完全一致
formatPrice 这类函数要小心浮点精度和区域设置
直接用 number_format($amount, 2, '.', ',') 看似简单，但实际项目中容易出错：比如传入字符串 "1999.9900" 可能被 PHP 自动转成科学计数法，或者 1999.995 四舍五入成 2000.00 而非预期的 1999.99。
更稳妥的做法是先 cast 成 float 并 round 到两位小数，再格式化：
public function formatPrice(float $amount): string
{
$rounded = round($amount, 2, PHP_ROUND_HALF_DOWN);
return '¥' . number_format($rounded, 2, '.', ',');
}
如果项目需支持多语言货币符号（如 €、$），不要硬编码 '¥'，应从 IntlCurrencyFormatter 或 Symfony 的 Intl 组件取值。
注册方式优先用自动发现，别手动配 twig.extension 标签
Symfony 5.4+ 默认启用 src/Twig/ 下扩展的自动注册，只要类满足两个条件：
– 命名空间以 App\Twig\ 开头
– 继承 AbstractExtension
手动在 config/services.yaml 里加 tags: [{ name: 'twig.extension' }] 是冗余操作，且容易因服务名拼错（比如写成 App\Twig\MyCustomExtension 却漏了 services: 缩进）导致扩展不生效。
验证是否注册成功，运行：bin/console debug:twig —— 查看输出里是否有你的函数名；
如果没出现，检查类路径是否真在 src/Twig/，以及命名空间是否匹配 App\Twig。
复杂格式化逻辑建议拆到 Service，Extension 只做胶水层
比如要做「带税率计算 + 多币种转换 + 促销折扣叠加」的价格渲染，把所有逻辑塞进 formatPrice() 会让函数难以测试、无法复用、违反单一职责。
正确做法是：
- 把核心计算逻辑写进
App\Service\PriceCalculator，注入RequestStack或LocaleResolver处理上下文 - 在 Extension 中只做轻量调用：
return $this->priceCalculator->render($amount, $options); - 这样既能单元测试
PriceCalculator，又能让模板保持简洁：{{ price(1999.99, { tax: true, currency: 'EUR' }) }}
Extension 本质是模板层的“适配器”，不是业务逻辑容器。越复杂的格式化，越要警惕把它变成隐藏的业务耦合点。
