render传变量有三种方式：直接传关联数组最常用；避免传引用或闭包；变量名避让Twig保留字。未定义变量需用is defined守卫或addGlobal注册延迟callable。@Template注解按vars属性或返回数组控制变量注入。
render 方法传变量的三种基本方式
直接传数组是最常用也最安全的方式，render() 第二个参数必须是关联数组，键名变成模板里的变量名，值支持任何 PHP 类型（包括对象、数组、null）。
- 控制器里写
$this->render('template.html.twig', ['user' => $user, 'posts' => $posts])，模板中就能用{{ user.name }}和{% for p in posts %} - 不要传引用或闭包——Twig 渲染时会克隆变量，引用失效；闭包无法序列化，会导致
Serialization of 'Closure' is not allowed - 如果变量名和 Twig 保留字冲突（比如叫
block、parent），模板里访问会出错，改名或加前缀（如data_block）
传 null 或空数组时模板报 Variable "xxx" does not exist 怎么办
这不是 render() 的锅，而是你没给模板提供它期待的变量。常见于复用片段（如 _sidebar.html.twig）被多个控制器调用，但只有部分控制器传了 budget。
- 在模板里加守卫：
{% if budget is defined %}{{ budget.count }}{% endif %} - 更推荐统一注入：用
TwigExtension+addGlobal()注册可延迟计算的全局变量，避免每个控制器都判空 - 别在控制器里用
isset($vars['budget']) ?: $vars['budget'] = null补缺——这掩盖了设计问题，且容易漏传
想把数据库统计值当变量传，但不想每次查一遍
直接在控制器里查再传，会导致 N+1 查询或重复执行。正确做法是让变量“按需加载”，而不是“提前塞满”。
- 定义一个服务（比如
BudgetStatsProvider），方法返回int，不带参数、无副作用 - 在
twig.extension中调用它：$twig->addGlobal('budget', $statsProvider->getCount());——但注意：这会在容器编译时就执行，不是延迟的 - 真正延迟的做法是传一个 callable：
$twig->addGlobal('budget', [$statsProvider, 'getCount']);，Twig 渲染到{{ budget }}时才调用
用 @Template 注解时变量怎么控制
@Template 是 SensioFrameworkExtraBundle 提供的语法糖，变量传递逻辑和 render() 一致，但默认行为容易误判。
- 方法返回
null且没设vars属性时，自动把所有参数名转为变量（public function show(User $user)→ 模板有user变量） - 一旦用了
vars: ['user']，就只传列出的变量，哪怕方法签名里还有$request或$options也不会进模板 - 若方法返回数组（如
return ['user' => $user, 'title' => 'Profile'];），@Template会忽略vars，直接用这个数组——这是唯一能绕过自动推导的方式
传变量本身很简单，难的是保持变量来源清晰、生命周期可控、错误可定位。尤其在多人协作项目里，看到模板里突然冒出来一个 {{ config.app_name }} 却找不到它在哪注册的，比语法错误更耗时间。
