默认情况下composer run-script静默捕获stderr，导致CI等非交互环境中报错信息丢失；应加-v参数、避免错误重定向、显式加载autoload、统一用__DIR__拼路径、导出PATH，并在CI中用-vvv和tee捕获完整日志。
脚本失败时为什么看不到报错信息
默认情况下，composer run-script 会静默捕获子进程的 stderr，尤其在非交互式环境（如 CI）中，错误直接被吞掉，只返回 Script xxx handling the xxx event returned with error code 1 这类泛泛提示。
实操建议：
- 加
-v（verbose）参数：运行composer run-script your-script -v，强制输出脚本执行的完整命令和原始 stderr - 避免在脚本定义里用
|| true或重定向2>/dev/null，这类写法会主动屏蔽错误流 - 如果脚本是 PHP 文件，确认没开启
@ini_set('display_errors', '0')或类似压制机制
如何让自定义脚本支持调试断点
Composer 脚本本质是 shell 命令或 PHP 回调，无法直接用 xdebug 断点，但可以绕过限制快速定位问题。
实操建议：
- Shell 类脚本：在关键行前加
read -p "Paused. Press Enter to continue..."，手动暂停观察上下文 - PHP 类脚本（如
"MyClass::myMethod"）：在方法开头插入if (getenv('COMPOSER_DEBUG')) { xdebug_break(); }，然后用COMPOSER_DEBUG=1 composer run-script xxx触发 - 统一加日志：用
error_log("DEBUG: value=".var_export($x, true));输出到 stderr，确保不被 Composer 截断
脚本路径和工作目录容易出错的地方
Composer 执行脚本时的 cwd 是项目根目录，不是 composer.json 所在目录（二者通常一致，但 symlink 或子模块场景下可能不同），且不会自动加载 vendor/autoload.php。
常见错误现象：
-
Class not found—— 脚本是 PHP 文件但没 require autoloader -
No such file or directory—— 脚本里用相对路径读取文件，实际执行位置不符预期 -
Command not found—— shell 脚本调用的命令依赖项目bin/目录，但 PATH 未包含它
实操建议：
- PHP 脚本开头显式加载：
require __DIR__.'/vendor/autoload.php'; - 所有文件路径用
__DIR__或getcwd()显式拼接，别信“当前目录就是这儿” - shell 脚本中加
export PATH="./vendor/bin:$PATH"确保能调用本地 bin 工具
CI 环境下脚本失败却无任何输出
某些 CI 平台（如 GitHub Actions 的 matrix job）会截断长 stderr，或 Composer 在非 TTY 环境下进一步降低日志等级。
实操建议：
- 强制启用全量日志：用
composer run-script xxx -vvv --no-ansi - 把脚本输出重定向到文件再上传：
composer run-script xxx -v 2>&1 | tee script.log || true，然后用cat script.log查看 - 检查 CI 是否设置了
COMPOSER_NO_INTERACTION=1—— 它本身不影响脚本执行，但可能掩盖需要交互的错误分支
composer run-script xxx -vvv，比反复猜更省时间。 
