执行 composer require twig/twig 后需手动配置 Loader 路径、缓存目录权限及环境参数，缺一不可：必须用绝对路径初始化 FilesystemLoader，启用 cache 和 debug 须匹配开发/生产环境要求，并确保 vendor/autoload.php 已加载。
直接执行 composer require twig/twig 就能引入 Twig，但“引入成功”不等于“能用”——90% 的失败发生在 Loader 路径、缓存权限或版本错配上，不是 Composer 的问题，是你代码里漏了关键环节。
composer require twig/twig 为什么装完还报 Class not found
不是没装上，而是 autoloader 没生效或命名空间写错。
- 先确认
vendor/autoload.php确实被require了：加一行var_dump(file_exists('vendor/autoload.php'));，输出true才算到位 -
Twig\Environment在 Twig 3 和 4 中路径一致，但旧代码里写的Twig_Loader_Filesystem（带下划线）在 Twig 4 已废弃，必须改用Twig\Loader\FilesystemLoader - 别手敲命名空间——打开
vendor/twig/twig/src/Environment.php，复制第一行namespace Twig;最稳 - IDE 补全推错类？清掉缓存并重新索引
vendor/目录
new Twig\Environment() 前必须 new Twig\Loader\FilesystemLoader()
Twig 不是单实例对象，它严格分层：Loader 负责找模板，Environment 负责编译和渲染。跳过 Loader 直接 new Environment 会抛 Fatal error: Uncaught TypeError: Twig\Environment::__construct(): Argument #1 ($loader) must be of type Twig\Loader\LoaderInterface。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 路径必须是真实存在的绝对路径：
new \Twig\Loader\FilesystemLoader(__DIR__ . '/templates')，别写'templates'—— CLI 下工作目录一变就找不到 - 模板目录要手动创建，且 Web 服务器用户（如
www-data）有读权限；Linux 下可执行chmod -R 755 templates/ - 支持多路径数组：
new \Twig\Loader\FilesystemLoader([__DIR__ . '/templates', __DIR__ . '/shared'])，Twig 按顺序查找 - 中文路径？确保文件系统和 PHP 都用 UTF-8 编码，否则可能报
Unable to find template
cache 和 debug 不是开关，是环境契约
这两个配置项不是“可开可关”，而是开发与生产环境的硬性分界线。
立即学习“PHP免费学习笔记（深入）”；
-
'cache' => false：开发时必须设，否则改模板不生效；但上线后留着它，每次请求都重新解析 Twig 源码，CPU 直接飙高 -
'cache' => __DIR__ . '/var/cache/twig'：目录需提前mkdir -p创建，并确保可写；否则 Twig 会静默失败或抛Twig\Error\RuntimeError -
'debug' => true：才能用{{ dump(user) }}，但必须已安装symfony/var-dumper（composer require symfony/var-dumper），否则提示 “dump function is not enabled” - 线上环境务必关掉
debug，否则{{ dump($_ENV) }}可能泄露数据库密码、API 密钥等敏感信息
最常被忽略的是缓存目录权限和 Loader 路径的绝对性——它们不会报错，只会让模板“渲染为空”或“始终 404”，排查时容易绕远路。动手前先跑通这三行：
$loader = new \Twig\Loader\FilesystemLoader(__DIR__ . '/templates');
$twig = new \Twig\Environment($loader, ['cache' => __DIR__ . '/var/cache/twig']);
echo $twig->render('index.html.twig', ['name' => 'Test']); 
