首先通过启用 Composer 的 -vvv 参数查看脚本调用详情，再在 PHP 脚本中使用 file_put_contents 写入日志确认执行状态与参数传递，接着将脚本脱离 Composer 独立运行以排查语法或路径问题，最后检查 composer.json 中 scripts 配置的命令路径与格式是否正确，结合这几种方法可高效调试自定义 Composer 脚本。
调试自定义的 Composer script 脚本时，关键在于让脚本输出执行过程中的信息，并确保它能在预期环境下正确运行。Composer 本身不提供内置的调试模式，但你可以通过几种实用方法来排查问题。
启用 Composer 的详细输出
在运行 Composer 命令时，加上 -v、-vv 或 -vvv 参数可以提升输出的详细程度，帮助你看到脚本是如何被调用的：
- composer run-script your-script-name -v
- composer run-script your-script-name -vvv
高详细模式会显示命令执行路径、环境变量以及脚本注册情况，有助于判断是否真正执行到了你的逻辑。
在脚本中添加日志输出
如果你的脚本是一个 PHP 回调（比如在 composer.json 中定义的类和方法），可以在代码中加入 var_dump、print_r 或写日志到文件的方式查看变量状态：
// 示例：在脚本处理类中public static function handle(Event $event)
{
file_put_contents('debug.log', 'Script started at: ' . date('Y-m-d H:i:s') . "\n", FILE_APPEND);
file_put_contents('debug.log', 'Args: ' . print_r($event->getArguments(), true) . "\n", FILE_APPEND);
// ... 其他逻辑
}
这种方式能让你清楚地看到脚本是否被触发、参数是否正确传递。
使用独立的可执行脚本进行测试
如果脚本是外部命令（如 shell 脚本或 PHP CLI 脚本），建议先脱离 Composer 单独运行，确认其行为符合预期：
- php your-custom-script.php
- ./scripts/deploy.sh
单独运行可以绕过 Composer 的执行封装，更容易定位语法错误、路径问题或权限异常。
检查脚本定义是否正确
确保 composer.json 中的 scripts 配置格式无误：
{"scripts": {
"my-script": [
"php bin/my-command.php",
"@php ./test.php"
]
}
}
注意命令路径是否正确，相对路径容易出错，推荐使用基于项目根目录的路径。
基本上就这些。通过组合日志、详细输出和独立测试，大多数脚本问题都能快速定位。关键是别依赖 Composer “自动运行”的黑盒感，主动暴露执行过程才是调试的核心。
