安装Twig的唯一正确命令是composer require twig/twig；必须包含斜杠，否则报错；需配置autoload、Loader与Environment配合使用，注意路径、权限、缓存及安全配置。
composer require twig/twig 就够了，别手抖漏斜杠
装 Twig 的唯一正确命令就是 composer require twig/twig。打成 composer require twig 会报 Could not find package twig——因为官方包名带命名空间，twig/twig 是固定写法，斜杠不能省。
常见错误现象：
- 网络慢或超时：国内建议先换镜像，
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - PHP 版本太低：Twig v3 要求 ≥ 7.2.5；若还在用 PHP 7.1，得显式指定
composer require "twig/twig:^2.15" - 装完类仍找不到：90% 是没在入口文件里
require 'vendor/autoload.php'，不是 Composer 没装好
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。
实操建议：
-
FilesystemLoader的路径必须真实存在且可读，推荐用绝对路径：new \Twig\Loader\FilesystemLoader(__DIR__ . '/templates') - 别写
new \Twig\Loader\FilesystemLoader('templates')——相对路径容易因 CLI 工作目录不同而失效 - 模板目录（如
templates/）要手动创建，Web 服务器用户（如www-data）需有读权限
cache 和 debug 不是“可选配置”，而是环境开关
'cache' => false 和 'debug' => true 看似可配可不配，实则直接影响开发效率和线上安全。
使用场景与风险：
- 开发时设
'cache' => false：改模板立刻生效；但上线后留着它，每次请求都重新编译，性能直接崩 -
'debug' => true才能用{{ dump(user) }}，但必须确保已装symfony/var-dumper并注册Twig\Extension\DebugExtension；上线前务必关掉，否则可能泄露$_ENV或数据库连接信息 - 缓存目录（如
'cache' => __DIR__ . '/var/cache/twig'）要提前mkdir -p创建，并确保可写，否则 Twig 会静默失败或抛出Twig\Error\RuntimeError
模板后缀、变量输出、raw 过滤器这些细节真会炸锅
Twig 默认对所有 {{ variable }} 输出做 HTML 转义，这是安全机制，不是 bug。但新手常因此发现“HTML 标签被当成纯文本显示”。
关键点：
- 模板文件名要匹配实际路径，比如
$twig->render('home.html.twig')，就得真有templates/home.html.twig，少一个.twig就报Twig\Error\LoaderError: Unable to find template - 想原样输出 HTML，必须加
|raw过滤器：{{ html_content|raw }}；但千万别对用户输入直接用|raw，否则 XSS 立刻中招 -
<?php ?>标签、{{ include('file.php') }}在 Twig 中默认禁用——它不是 PHP 解释器，是模板引擎，职责就是渲染，不是执行逻辑
最常被忽略的其实是 loader 路径的真实性和 cache 目录的写权限。这两点不出错，剩下的基本都是语法和配置问题，查文档也快。但一旦卡在这儿，花半天都未必意识到是路径或权限惹的祸。
