Symfony项目默认集成Twig，安装需确保PHP≥7.4、扩展启用及Composer可用；推荐用symfony new --full或composer create-project初始化；Twig模板须置于templates/目录，控制器中以相对路径调用，如'render('index.html.twig')'。
Symfony 安装本身不难，关键是环境稳、命令对、验证及时；Twig 在 Symfony 里不是“要装的插件”，而是开箱即用的核心视图层——只要项目是用 symfony new 或 composer create-project 初始化的，默认就已集成并配置好。
安装前必须确认的三件事
很多问题其实卡在起步阶段：
- PHP 版本 ≥ 7.4（推荐 8.0+），运行
php -v查看；确保启用了intl、mbstring、xml、curl等扩展 - Composer 已全局可用，执行
composer -v能输出版本号；国内用户建议提前配置镜像源，避免依赖下载失败 - 网络通畅，能正常访问 Packagist 和 Symfony 官方资源
两种主流安装方式，按需选择
不需要纠结“哪个更好”，只看当前目标：
-
轻量学习或微服务场景：用 Composer 骨架项目
执行composer create-project symfony/skeleton my_project，生成最小化结构，组件按需加载 -
新手上手或快速开发 Web 应用：用 Symfony CLI 完整版
先安装 CLI（macOS：brew install symfony-cli/tap/symfony-cli），再执行symfony new my_project --full，自动包含 Twig、Doctrine、Webpack Encore、Security 等常用功能
Twig 模板路径与调用规范
90% 的“找不到模板”错误，都出在路径写法上。记住：templates/ 是根，不是子目录。
立即学习“PHP免费学习笔记（深入）”；
- 所有 Twig 文件必须放在
templates/目录下（如templates/index.html.twig） - 控制器中调用必须用相对路径，不带前导斜杠：
$this->render('index.html.twig')→ 查找templates/index.html.twig - 支持子目录结构：
$this->render('blog/post.html.twig')→ 对应templates/blog/post.html.twig - 绝对路径写法（如
/templates/xxx或templates/xxx）全部无效
快速验证 Twig 是否正常工作
别靠猜，用三条命令直接确认：
- 运行
php bin/console debug:config twig，检查输出中paths是否指向%kernel.project_dir%/templates - 确认
config/packages/twig.yaml文件存在（哪怕为空），否则 Twig Bundle 不会激活 - 新建一个
templates/test.html.twig，内容为<h1>OK</h1>，在控制器中调用$this->render('test.html.twig')，能正常显示即说明通路已通
