默认 composer require twig/twig 安装 Twig 4.x，但 PHP ≤ 8.0 或 Symfony 5.x 项目需显式指定 ^3.15；命名空间、loader 路径和 debug 开关配置错误是常见运行时问题。
composer require twig/twig 会装错版本？
默认执行 composer require twig/twig 装的是 Twig 4.x（2024 年起已成主流），但很多老项目还依赖 PHP 7.4 或用着 Symfony 5.x，这些环境跑不起来 Twig 4。不是“装不上”，而是运行时抛 ParseError 或 TypeError —— 比如 Twig\Environment 构造函数签名变了，或 Twig\Loader\ArrayLoader 被移除了。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查清当前 PHP 版本：
php -v；再看框架/项目是否锁了symfony/twig-bridge版本 - 若 PHP ≤ 8.0 或用 Symfony 5.x，显式指定 Twig 3：
composer require twig/twig:^3.15 - 若 PHP ≥ 8.1 且无历史包袱，直接
composer require twig/twig即可，默认得 4.x - 别信 packagist 页面顶部写的“Latest version”——它不看你环境，只按发布时间排
autoload 后 new Twig\Environment 报 Class not found？
Composer 安装完，require 'vendor/autoload.php' 也写了，但 new Twig\Environment(...) 还是报错，大概率是命名空间没对上，或者 autoloader 没生效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认
vendor/autoload.php确实被引入了（加个var_dump(file_exists('vendor/autoload.php'));快速验证） - Twig 4 的核心类在
Twig\Environment，Twig 3 也是，但 loader 类路径不同：Twig 3 用Twig\Loader\FilesystemLoader，Twig 4 保留但弃用了Twig_Loader_Filesystem（旧写法） - 别手敲命名空间——复制 vendor/twig/twig/src/Environment.php 里的
namespace行最保险 - 如果用 IDE，清缓存 + 重新索引 vendor，否则自动补全可能推错类名
模板里 {{ dump() }} 不输出、或提示 “dump function is not enabled”
{{ dump() }} 是调试利器，但默认关闭。不是你写错了，是 Twig 故意拦住了——防止上线后泄露数据。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 启用前先确认已装
symfony/var-dumper（Twig 4 强依赖它）：composer require symfony/var-dumper - Twig 3：初始化
Environment时传第三个参数数组，加'debug' => true，再调$loader->addFunction(new \Twig\TwigFunction('dump', 'dump')) - Twig 4：更简单，只需
new \Twig\Environment($loader, ['debug' => true])，然后composer require symfony/debug-bundle（非必须，但推荐） - 线上环境务必关掉
debug，否则{{ dump(_POST) }}可能直接打出所有表单数据
渲染时提示 “Template “xxx.twig” not found”
路径问题最常见：不是模板文件不存在，而是 FilesystemLoader 根目录设错了，或者用了相对路径但工作目录（getcwd）和预期不一致。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- loader 初始化必须用绝对路径：
new \Twig\Loader\FilesystemLoader(__DIR__ . '/templates')，别用./templates - 检查
templates目录是否存在、权限是否允许 PHP 读取（尤其 Linux 下的 SELinux 或 open_basedir 限制） - 模板名传给
render()时，是相对于 loader 根目录的路径，不带扩展名：$twig->render('home.twig')→ loader 会找templates/home.twig - 如果用子目录，比如
templates/admin/dashboard.twig，渲染时写'admin/dashboard'，不是'admin/dashboard.twig'
