Symfony中设Twig全局变量分两种：静态值直接配twig.yaml，动态值须用实现GlobalsExtensionInterface的服务注入；避免滥用，仅适用于跨页面复用、计算成本可控的数据。
在 Symfony 中设 Twig 全局变量，核心就两条路：简单值用配置直写，动态或对象类数据必须靠服务注入。别硬塞数据库查询到 config.yml 里——那会拖慢所有页面渲染。
静态值：直接配进 twig.yaml
适合网站名、统计开关、GA 跟踪码这类不变的字符串或布尔值。Symfony 5.4+ 默认用 config/packages/twig.yaml：
- 打开该文件，在
twig:下加globals:块 - 写法是键值对，值可直接写死，也可引用参数（推荐）
例如：
twig:
globals:
site_name: 'MyApp'
ga_code: '%env(GA_CODE)%'
is_prod: '%kernel.environment%' == 'prod'
之后所有模板都能直接用 {{ site_name }} 或 {% if is_prod %}，无需控制器传参。
动态值：用 Twig 扩展 + 服务
像“用户总数”“未读消息数”“预算剩余”这种要查库、调 API、带缓存逻辑的，必须走 Twig\Extension\GlobalsExtension 接口。它比老式 getGlobals() 方法更规范、更易测试。
- 新建一个类，实现
Twig\Extension\GlobalsExtension - 在
getGlobals()方法里返回关联数组，键即模板变量名 - 构造函数里注入你需要的服务（如
EntityManagerInterface、CacheInterface）
示例关键代码：
class AppGlobalsExtension implements Twig\Extension\GlobalsExtensionInterface
{
public function __construct(
private EntityManagerInterface $em,
private CacheInterface $cache
) {}
public function getGlobals(): array
{
$count = $this->cache->get('user_count', function () {
return $this->em->getRepository(User::class)->count([]);
});
return [
'user_count' => $count,
'budget' => $this->getBudgetSummary(), // 自定义方法
];
}
}
注册为服务时确保自动加载（Symfony 默认启用），无需额外 YAML 配置。
注意变量作用域和性能边界
全局变量不是万能胶。以下情况应避免用它：
- 只在单个页面或少数几个模板里用的数据——直接 controller 传更清晰
- 每次渲染都执行耗时查询（比如没加缓存的 COUNT(*)）——用户一刷侧边栏，整站变卡
- 依赖当前用户权限或请求上下文的值（如
current_user.permissions）——应走 Twig 函数或宏，而非全局变量
真正该放进去的，是那些跨页面复用、计算成本可控、且不随请求剧烈变化的数据。
调试与验证技巧
设完别急着刷新页面。先确认是否生效：
- 运行
bin/console debug:container --parameter=twig.globals看配置项是否加载 - 在任意模板里加
{{ dump(_context) }}查看所有可用变量（开发环境） - 检查 Twig 编译缓存是否过期：
rm -rf var/cache/dev/twig
如果变量显示 null 或报 “Variable does not exist”，大概率是扩展类没被识别、服务未正确注入，或缓存没清干净。
