Symfony适用于中大型、需长期维护的PHP应用，新手应先用website-skeleton快速启动项目，掌握php bin/console命令、YAML配置、Twig模板规范及服务设计原则。
别从“学框架”开始，先确认你真需要 Symfony —— 它不是给单页表单或静态博客用的，而是为中大型、需长期维护、多人协作的 PHP 应用准备的。如果你的项目连 Doctrine ORM 和服务容器都还没必要，硬上 Symfony 只会拖慢进度、增加认知负担。
先跑通一个 symfony/website-skeleton 再谈学习路径
新手最容易卡在环境和初始化阶段，不是概念没懂，是根本没跑起来。别碰 symfony/skeleton（太精简），也别手动配 Apache/Nginx，更别用过时的 symfony-installer（已废弃）。
- 确保 PHP ≥ 8.1，
composer已全局可用（运行composer --version验证） - 执行：
composer create-project symfony/website-skeleton myapp（带 Web 堆栈，含 Twig、WebProfilerBundle、Doctrine） - 进目录后直接用内置服务器：
cd myapp && php -S localhost:8000 -t public - 浏览器打开
http://localhost:8000，看到 Symfony welcome page 才算真正起步
如果报错 Failed to load resource: the server responded with a status of 404 (Not Found)，大概率是没指定 -t public；若提示 Class 'App\Controller\DefaultController' not found，说明你装的是新版（6.4+），它默认删了 DefaultController，直接访问根路径即可，不用找控制器文件。
php bin/console 是你每天第一个要敲的命令
Symfony 的 CLI 不是锦上添花，是核心操作入口。不熟这个，后面所有功能（路由、数据库、缓存）都会卡住。
立即学习“PHP免费学习笔记（深入）”；
-
php bin/console list：看有哪些命令可用（别死记，常看） -
php bin/console make:controller HelloController：生成控制器（make系列依赖 MakerBundle，website-skeleton已预装） -
php bin/console make:entity User：生成实体类（自动加注解、问字段类型、是否 nullable） -
php bin/console doctrine:migrations:diff && php bin/console doctrine:migrations:migrate：建表（别手写 SQL 或改 schema.yml）
注意：make: 命令生成的代码不是“样板”，而是符合当前 Symfony 版本规范的可运行代码。别删它、别重写，先跑通再改。
别跳过 config/packages/ 里的 YAML 文件
很多人以为 Symfony 的配置全在注解里，其实关键行为由 config/packages/ 下的 YAML 控制。比如：
- 想关掉 WebProfiler（生产环境必须关）？改
config/packages/web_profiler.yaml里的enabled值，不是删掉 bundle - 想让
dump()在浏览器里显示漂亮结构？确保config/packages/debug.yaml中debug: true且环境是dev - 换数据库驱动？改
config/packages/doctrine.yaml里的url，不是改.env就完事（.env只是变量源）
这些文件改动后无需重启服务器（开发模式下），但改错会导致整个应用启动失败，错误信息会直接打在终端或浏览器里 —— 别忽略它，The service "xxx" has a dependency on a non-existent service "yyy" 这类报错，90% 出在 YAML 配置拼写或缩进错误。
Twig 模板里别写 PHP 逻辑，但得懂 {{ }} 和 {% %} 的边界
Twig 不是 PHP 模板，它是沙盒化的。你不能在 {{ }} 里调方法链（{{ user.getProfile().getName() }} 会报错），也不能在 {% %} 里用 echo。
- 安全输出变量：
{{ user.name|e }}（|e是默认过滤器，防 XSS） - 条件判断写法：
{% if user.isActive %}...{% endif %}，不是<?php if(...) { ... } ?> - 复用模板片段：
{% include 'partials/_header.html.twig' %}，路径基于templates/根目录 - 传参给子模板：
{% include 'form/_field.html.twig' with {label: 'Email'} %}
常见坑：{{ dump(user) }} 在生产环境默认禁用，且会暴露敏感数据；{{ user.createdAt|date('Y-m-d') }} 如果 createdAt 是 null，会抛异常 —— 加 |default('N/A') 更健壮。
真正难的不是语法，是判断什么时候该用 Service 封装逻辑、什么时候该抽成 Event Listener、什么时候该写自定义 Validator。这些决策点不会出现在入门教程里，但会在你加第 3 个业务模块时突然冒出来 —— 到那时，翻 src/ 下已有类的写法，比查文档更快。
