Composer不支持脚本合并，仅支持通过数组顺序执行或多命令串联（如&&）；数组形式跨平台且失败中断，shell串联需注意兼容性与错误传播。
Composer 本身不支持“合并脚本”这个概念——scripts 字段里的命令是独立定义、按需执行的，不存在像 Docker Compose 那样的多文件深度合并逻辑。所谓“合并”，实际是指多个脚本命令的组合调用、嵌套或顺序执行，核心靠的是 shell 层面的串联和 Composer 自身的事件钩子机制。
composer.json 里怎么写多命令串联？
在 scripts 中直接用 && 或 ; 连接多个命令是可行的，但要注意 shell 兼容性和错误传播：
-
&&表示前一个命令成功才执行下一个，适合有依赖关系的操作（比如先生成 autoload 再跑测试） -
;无条件执行后续命令，哪怕中间失败也继续，容易掩盖问题 - Windows CMD 不支持
&&，但 Git Bash / WSL / macOS/Linux 均支持；若需跨平台，建议封装为 PHP 脚本或使用composer run-script嵌套
示例（Linux/macOS 安全写法）：
"scripts": {
"build": [
"composer dump-autoload -o",
"php artisan config:clear && php artisan cache:clear"
],
"test-ci": "vendor/bin/phpunit --no-coverage && composer run-script post-test-cmd"
}
如何让多个自定义脚本按顺序执行？
Composer 支持数组形式的 script 值，会按顺序依次执行每一项，且任意一项失败即中断：
- 数组写法天然跨平台，比 shell 连接符更可靠
- 每项可以是 shell 命令、PHP 脚本路径，甚至另一个
composer run-script xxx - 注意：如果某项是
composer run-script yyy，它内部失败不会自动终止外层数组执行，除非加--no-interaction和检查退出码
常见误用：
"scripts": {
"deploy": [
"php deploy/prep.php",
"composer install --no-dev",
"php deploy/migrate.php"
]
}
这样写没问题；但若把三行压成一个字符串（如 "php deploy/prep.php && composer install --no-dev && php deploy/migrate.php"），就丧失了 Composer 对每步失败的捕获能力。
post-install-cmd 和 post-update-cmd 怎么复用已有脚本？
可以直接在生命周期事件中调用已定义的自定义脚本名，实现逻辑复用：
- 避免重复写命令，也方便统一维护
- 调用时用
composer run-script xxx，不能省略run-script - 注意循环调用风险：比如
post-install-cmd调用了build，而build又触发了post-install-cmd—— Composer 不会自动检测，得靠脚本自身 guard
正确写法：
"scripts": {
"build": "composer dump-autoload -o && php artisan optimize:clear",
"post-install-cmd": [
"@build",
"php artisan storage:link"
],
"post-update-cmd": ["@build"]
}
其中 @build 是 Composer 的语法糖，等价于 composer run-script build。
为什么有时候脚本执行了但没生效？
最常被忽略的三点：
- 当前目录下没有有效的
composer.json：Composer 不会向上查找，Could not find a composer.json file就是这个原因 - 脚本里用了相对路径（如
php tests/run.php），但执行位置不在项目根目录，导致文件找不到 - PHP 版本不匹配：比如脚本里调用了
php8.2特有的函数，但系统默认php是 8.1，报错却不明显
调试建议：加 -v 参数看完整输出，或在脚本开头加 echo "PWD: $(pwd)" && php --version 确认上下文。
