自定义 Twig 扩展在 Symfony 中必须显式注册为带 twig.extension 标签的服务，否则无法使用；依赖服务需构造注入，参数默认值须手动配置，同名函数会覆盖原生功能，缓存需手动清除。
直接上结论：自定义 Twig 扩展在 Symfony 中不是“能不能做”，而是“怎么注册对、参数传准、缓存别踩坑”。错一个环节，price 过滤器可能在模板里报 Unknown "price" filter，或者参数默认值失效、服务未延迟加载导致性能下降。
如何正确注册 Twig 扩展为服务
扩展类写完不等于能用，必须显式标记为 twig.extension 服务标签。Symfony 不会自动扫描或注册继承 AbstractExtension 的类。
- 在
config/services.yaml中明确声明服务并加标签：App\Twig\AppExtension: tags: ['twig.extension'] - 如果扩展依赖其他服务（如
RouterInterface或TranslatorInterface），必须在构造函数中声明，并在服务定义中注入；否则getFunctions()里调用时会因$this->router为null报错 - Symfony 5.3+ 支持
#[AsTwigFilter]或#[AsTwigFunction]注解，但仅适用于**无依赖的静态方法**；有依赖仍需传统服务注册方式
过滤器参数默认值为何不生效
常见现象：模板里写 {{ 1299|price }} 报错 “Too few arguments”，但方法签名明明写了 $decimals = 0。根本原因是 TwigFilter 构造时不自动识别 PHP 默认参数，必须显式传入 isVariadic 或用 needsEnvironment 等选项控制行为。
- 正确写法是用
new TwigFilter('price', [$this, 'formatPrice'], ['is_safe' => ['html']])，不加额外配置时，Twig 严格按方法签名校验参数个数 - 若想支持可选参数，方法本身要兼容空参调用，例如：
public function formatPrice($number, $decimals = 0, $decPoint = '.', $thousandsSep = ',') { if (!is_numeric($number)) { return ''; } return '$' . number_format($number, $decimals, $decPoint, $thousandsSep); } - 避免在过滤器里做 heavy IO（如查数据库），它会在每次渲染时同步执行
为什么自定义 path() 函数会覆盖全局路由行为
重写 path() 是高危操作。Twig 的 path 函数由 RoutingExtension 提供，你写的同名函数会直接替换它——不只是新增，而是覆盖。一旦出错，整个应用的链接生成都会中断。
- 务必确认是否真需要全局覆盖；多数场景只需新增一个
admin_path()或api_path()函数更安全 - 若必须覆盖，继承原始
RoutingExtension并复用其逻辑，而不是从头实现：class CustomRoutingExtension extends RoutingExtension { public function getFunctions(): array { return [ new TwigFunction('path', [$this, 'getPath']), ]; } public function getPath(string $name, array $parameters = []): string { // 加日志、加前缀、加环境判断等 return parent::getPath($name, $parameters); } } - 注册时注意优先级：多个同名函数，最后注册的胜出；可用
priority标签控制，如['twig.extension', 'priority' => 10]
最常被忽略的是缓存：开发时改了扩展逻辑，但 Twig 缓存没清，模板还在用旧版本。执行 php bin/console cache:clear 后，务必确认 var/cache/dev/twig/ 下对应模板编译文件已被更新，否则你会花半小时调试一个早已修复的问题。
