零基础学 symfony 应先用 cli 创建项目并阅读骨架代码，而非直接读官方文档；make:command 生成的带注释代码、调试栏和 debug:container 命令比文档更直观实用。
零基础直接啃 Symfony 官方文档，90% 的人会在第一页就卡住——不是因为看不懂英文，而是文档默认你已理解框架的组织逻辑、术语边界和工具链依赖。官方文档是参考手册，不是入门教程；它不解释 make:controller 为什么比手写 AbstractController 更安全，也不提醒你 symfony server:start 和 php -S 的根本差异。
别从 docs.symfony.com 开始读
官方文档首页罗列的是“组件 API”和“Bundle 参考”，比如 OptionsResolver 或 CacheInterface。零基础用户看到这些，就像刚学加法就被扔进微积分证明题里。真正该先看的，是 Symfony CLI 自带的交互式引导和项目骨架的注释代码。
- 运行
symfony new myapp --full后，README.md里有当前项目实际启用的 Bundle 列表和关键命令速查 -
config/bundles.php是真实注册的 Bundle 清单，比文档里抽象的“Bundle 概念”直观十倍 - 所有
make:命令生成的代码（如make:controller）都带完整注释，且符合当前项目配置，比文档示例更贴近实战
make:controller 生成的代码比文档示例更值得细读
官方文档里写的控制器常省略关键细节：没声明返回类型、没写 @Route 的 methods 参数、用 Response::create() 而非 $this->render()。但 make:controller 输出的代码强制包含：
- PHP 8+ 返回类型声明（
public function index(): Response） - 路由注解含
methods={"GET"}，避免 CSRF 隐患 - 模板路径用字符串字面量（
'home/index.html.twig'），不依赖 Bundle 别名或符号引用 - 自动注入
Request对象，而非手动从全局获取
这些不是“最佳实践”的说教，而是当前项目配置下能跑通的最小安全范式。
调试栏（Web Debug Toolbar）比文档的“调试章节”管用十倍
文档里讲 Xdebug 配置、日志级别、Profiler 数据结构，但新手真正需要的，是“点一下就知道哪错了”。紫色调试栏（右下角）直接暴露三类关键信息：
- 点击
Router查看当前 URL 匹配了哪个@Route，参数是否被正确解析（常见坑：/user/{id}写成/user/{id}导致匹配失败） - 点击
Twig看变量值、模板继承链、被 include 的片段路径（避免@App/foo.html.twig找不到文件却报错在控制器里） - 点击
Logs过滤doctrine或security类型日志，比翻var/log/dev.log快得多
遇到白屏，先点调试栏；它不告诉你“为什么”，但会精准定位“在哪一步断的”。
环境变量和 .env 文件的实际加载顺序容易被文档误导
文档说“环境变量优先级：系统 > .env.local > .env”，但没强调：Symfony 启动时只读一次 .env，之后改了要重启服务；而 symfony server:start 会自动监听 .env 变更并热重载，php -S 不会。
-
APP_ENV=prod在.env里设了，但控制台仍显示 dev？检查是否被.env.local覆盖，或终端里执行过export APP_ENV=dev - 数据库密码含
$或:时，必须用单引号包裹：DATABASE_URL='mysql://root:pass$word@127.0.0.1:3306/app'，否则 shell 会提前解析 -
php bin/console debug:container --env-var=DATABASE_URL是验证当前生效值的唯一可靠方式，别信 IDE 的环境变量提示
文档把环境变量当静态配置讲，但实际它是启动瞬间的快照——这个时间差，是本地开发最常掉进去的坑。
