开启错误报告并使用var_dump、日志记录和xdebug是调试PHP命令行脚本的关键：首先确保display_errors=On和error_reporting=E_ALL，或在脚本中用ini_set启用；接着通过var_dump($var)或print_r($argv)直观查看变量；对于后台运行脚本，推荐error_log写入日志文件以便追踪；若需深入调试，可配置xdebug扩展并结合IDE实现断点调试，提升排查效率。养成开启错误提示和记录日志的习惯，能显著降低调试成本。
调试PHP命令行脚本的关键在于正确输出错误信息、使用调试工具和日志追踪。与Web环境不同，命令行（CLI）模式下错误不会自动显示在浏览器中，因此需要手动开启错误报告并合理利用调试手段。
开启错误报告与显示
确保PHP在命令行中能输出所有错误和警告，有助于快速定位问题：
- display_errors = On：让错误直接输出到终端
- error_reporting = E_ALL：报告所有级别的错误
可以在脚本开头添加以下代码强制开启：
ini_set('display_errors', 1);
ini_set('error_reporting', E_ALL);
使用var_dump或print_r进行变量检查
在关键位置输出变量内容，是调试最基本也最有效的方法：
立即学习“PHP免费学习笔记（深入）”；
var_dump($variable); print_r($argv); // 查看传入的命令行参数
注意：CLI环境下没有HTML标签干扰，var_dump输出更清晰。
利用日志记录替代echo调试
对于长时间运行或后台执行的脚本，建议将调试信息写入日志文件：
error_log("当前状态: " . print_r($data, true) . "\n", 3, "/tmp/debug.log");
这样不会影响标准输出，同时便于后续分析。
使用xdebug进行高级调试
如果安装了xdebug扩展，可通过IDE（如PhpStorm、VS Code）实现断点调试：
- 确保php.ini中启用xdebug：extension=xdebug
- 设置远程调试参数：xdebug.mode=debug，xdebug.start_with_request=yes
- 配合IDE监听调试连接，即可逐行执行脚本
适用于复杂逻辑或难以通过日志排查的问题。
基本上就这些。只要打开错误提示、善用输出检查、必要时接入xdebug，命令行脚本的调试并不复杂，但容易忽略配置差异。保持习惯性的日志记录，能大幅减少排查时间。
