装完 Symfony 项目，先让欢迎页跑起来、确认 Web Profiler 工具栏亮起，这两步才是开发真正开始的标志：执行 composer create-project symfony/website-skeleton myapp，运行 php bin/console about 确认 Flex: enabled 和 APP_ENV=dev，启动 php -S localhost:8000 -t public，访问 https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774 看到欢迎页；再检查 .env 中 APP_DEBUG=1，验证页面底部存在 ，并能通过 /_profiler/{token} 访问调试数据。
装完 Symfony 项目，别急着写代码——先让欢迎页跑起来、确认 Web Profiler 工具栏亮起，这两步才是开发真正开始的标志。环境没通，后续所有调试和功能都无从谈起。
第一步：5分钟跑通欢迎页
用官网推荐的完整堆栈模板起步，跳过 skeleton 和手动配置：
- 执行
composer create-project symfony/website-skeleton myapp，它自动集成 Twig、Doctrine、MakerBundle 和 Flex - 进项目目录后立刻运行
php bin/console about，确认输出中显示 Flex: enabled 和 Environment: dev - 启动内置服务器：
php -S localhost:8000 -t public（注意是-t public，不是index.php） - 浏览器打开 https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774，看到 Symfony 欢迎页才算基础环境就绪
第二步：确保 Web Profiler 工具栏可见
工具栏（WDT）不出现，90% 是 kernel.debug 没在启动时生效，而不是配置漏了：
- 检查
.env文件：必须有APP_ENV=dev和APP_DEBUG=1，且不能只在 YAML 配置里写 debug: true - 验证 Kernel 是否真加载了调试模式：在控制器里加
dump($this->getParameter('kernel.debug'))，输出必须是 true - 查看页面源码底部——必须存在
<script id="sfwdt"></script>，没有说明响应被截断（如用了ob_end_clean()、模板里写了exit，或 base 模板漏了{{ render_profiler() }}） - 若 HTML 里有脚本但工具栏仍不显示，打开浏览器 Network 面板，找带
X-Debug-Token响应头的请求，复制 token 手动访问https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774/_profiler/{token}，能打开即证明数据已采集
第三步：用好 Profiler 的四个关键面板
点击底部工具栏图标，直接进入对应分析页，重点关注这些信号：
- 200 OK 图标（Overview）：看总耗时是否突增、SQL 查询数是否异常飙升、Twig 渲染次数是否远超预期
-
DB 图标（Doctrine）：标红的慢查询（>100ms）要立刻
EXPLAIN；重复出现的相同 SQL 很可能是 N+1 问题 - ⏱️ 图标（Timeline）：拖动时间轴定位卡点——若 “Controller” 耗时高，检查构造函数注入服务是否过多；若 “twig.template” 占比大，考虑模板嵌套过深或未启用片段缓存
-
❗ 图标（Logs）：筛选
doctrine或security通道，快速定位权限拒绝、空结果或查询失败的具体上下文
第四步：常见静默失败的修复动作
工具栏空白、dump() 不显示、Profiler 数据为空——往往不是装错了，而是链路中断：
- 清缓存：
php bin/console cache:clear，尤其首次访问前，避免因权限问题卡在 500 错误 - 检查路由是否被覆盖：运行
php bin/console debug:router，确认存在_wdt和_profiler开头的路由；若缺失，创建config/routes/dev/web_profiler.yaml并填入标准路由配置 - CLI 命令不触发 Profiler 是正常行为，如需分析，手动调用：
$profiler = $this->getContainer()->get('profiler'); $profiler->enable(); - 敏感数据被脱敏是默认行为，
$_ENV、$_SERVER中的密码类字段会自动隐藏，不是 dump 失败
