开启调试模式需同时设置APP_ENV=dev和APP_DEBUG=1两个环境变量于.env文件，缺一不可；仅修改配置文件或命令行参数无效，必须在Kernel构造前生效。
Symfony安装后开启调试模式，关键不是改配置文件，而是在应用启动的最早阶段就让kernel.debug参数为true。这个值一旦在Kernel构造时确定，后续任何YAML或PHP配置修改都无效。
必须设置的两个环境变量
调试模式依赖两个核心环境变量协同生效，缺一不可：
-
APP_ENV=dev：决定加载
config/packages/dev/下的配置，并启用开发专用Bundle（如WebProfilerBundle） -
APP_DEBUG=1（或
true）：直接控制kernel.debug容器参数，是DebugBundle、错误处理器、VarDumper等所有调试能力的总开关
这两个变量需写在项目根目录的.env文件中，格式为纯文本键值对（等号前后无空格）：
APP_DEBUG=1
验证是否真正生效
不能只看.env有没有写，必须确认运行时值已落地：
- 在控制器或服务中执行
dump($this->getParameter('kernel.debug'))，输出必须是true - 运行命令
php bin/console debug:dotenv，检查输出中APP_ENV和APP_DEBUG是否被正确加载且未被覆盖 - 访问页面后查看HTML源码底部，确认存在
<script id="sfwdt"></script>——没有说明响应被截断或模板漏了{{ render_profiler() }}
常见失效原因与修复
以下操作看似合理，但实际无法开启调试模式：
- 只在
config/packages/dev/debug.yaml里写debug: true→ 文件加载太晚，DebugBundle早已跳过初始化 - 用
php bin/console --env=dev运行命令 →--env参数已被弃用，应改用APP_ENV=dev php bin/console - 在
public/index.php中手动传debug => true但$_SERVER['APP_DEBUG']仍为false→ 环境变量未设，Kernel构造时取不到真实值
正确做法是确保.env存在且内容正确，再清缓存：php bin/console cache:clear（开发环境下自动跳过部分缓存，无需强制--no-warmup）。
配套工具建议安装
开启调试模式后，推荐补全基础调试能力：
- 安装
symfony/debug-pack：composer require --dev symfony/debug-pack，自动集成DebugBundle、MonologBundle、WebProfilerBundle - 如只需性能分析，可单独装
symfony/profiler-pack：composer require --dev symfony/profiler-pack - Twig模板中安全使用
dump()，需确认config/packages/twig.yaml含debug: '%kernel.debug%'和strict_variables: '%kernel.debug%'
