symfony命令行调试核心是“看得到、停得准、查得清”：用-vvv展开执行链路，dump/dd安全输出变量并聚合至/_wdt，traceablecommand配合--debug和profiler定位耗时瓶颈，-q/--no-interaction/--help验证输入输出行为。
命令行逻辑出错，别急着翻源码。Symfony 提供了一套轻量、直接、不打断执行流的调试方式，核心是“看得到、停得准、查得清”。
用好 -vvv 查执行细节
多数命令本身不输出中间状态，但加 -vvv 就能展开完整执行链路：参数解析、选项绑定、事件触发、服务调用顺序全都有。比如：
-
php bin/console app:import-data --file=users.csv -vvv会显示每一批数据加载前后的内存变化、每个 Doctrine 实体的 persist 状态 - 若某步卡住或跳过，-vvv 输出里通常能发现被忽略的条件判断或未注册的事件监听器
在命令中安全 dump 变量
不用 var_dump() 搞乱终端输出。直接在命令的 execute() 方法里写：
-
dump($this->input->getArgument('batch-size'));—— 查传入值是否被截断或类型转换异常 -
dump($items); dd();—— 在关键节点中断并查看集合结构，尤其适合处理大量数据时定位某次循环异常 - 所有
dump()输出会自动聚合到http://localhost:8000/_wdt的 “Dump” 面板，AJAX 或后台命令也看得见
用 TraceableCommand 定位耗时瓶颈
如果命令执行慢，不是靠猜哪段代码拖后腿。继承 TraceableCommand，它会自动记录每个方法调用耗时：
- 在
configure()中设置$this->setName('app:sync-users') - 运行时加上
--debug，控制台会输出类似[217ms] App\Command\SyncUsersCommand::processBatch()的标记 - 配合 Profiler 访问
/_profiler，点开 “Timeline” 标签，可看到命令内部各阶段真实耗时分布
检查输入/输出行为是否符合预期
命令的交互逻辑容易被忽略。用标准选项快速验证：
-
-q（静默）：只留错误，排除干扰信息，确认报错是否稳定复现 -
--no-interaction：绕过所有交互提示，测试自动化场景下逻辑是否断裂 -
--help：确认参数定义是否与文档一致，比如必填项没标InputArgument::REQUIRED就会导致空值静默通过
