加--no-scripts即可跳过post-install-cmd,它会屏蔽composer.json中scripts字段定义的所有生命周期脚本(如pre/post-install-cmd等),不影响依赖安装和autoload.php生成,常用于CI中避免因环境缺失导致脚本失败。

composer install 时怎么跳过 post-install-cmd 脚本?
加 --no-scripts 就行,它会跳过所有 scripts 字段里定义的生命周期脚本,包括 post-install-cmd、post-update-cmd 等。
常见错误现象:CI 流水线执行 composer install 后自动跑 php artisan migrate 或 chmod -R 755 storage/,结果因权限或数据库未就绪而失败。
-
--no-scripts是开关,不是可选参数——不带它,默认就会触发脚本;带上才禁用 - 它不影响依赖安装本身,只屏蔽脚本执行
- 和
--no-dev、--ignore-platform-reqs可安全组合使用,比如 CI 中常用:composer install --no-interaction --no-scripts --no-dev --ignore-platform-reqs - 注意:
--no-scripts不会跳过 autoload 生成(vendor/autoload.php仍会写),除非额外加--no-autoloader
composer update 跳过脚本但保留 lock 更新
composer update 默认会触发 post-update-cmd,想让它重算依赖并更新 composer.lock,但不执行后续命令,同样靠 --no-scripts。
使用场景:本地开发改了 composer.json,只想快速拉下新版本包、更新锁文件,不希望立刻清缓存或跑测试。
- 单独用
composer update --no-scripts即可,不需要加--no-check-lock(update 本来就不校验 lock) - 如果只更新某几个包,如
composer update monolog/monolog symfony/console,--no-scripts依然生效 - 别误用
--no-autoloader:它会跳过 autoloader 重建,导致new Class()找不到类,这不是“跳过脚本”,是破坏运行基础
哪些脚本会被 --no-scripts 彻底绕过?
--no-scripts 屏蔽的是 composer.json 顶层 scripts 字段中所有以 -cmd 结尾的事件名,包括:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
pre-install-cmd和post-install-cmd -
pre-update-cmd和post-update-cmd -
pre-root-package-install和post-root-package-install -
pre-create-project-cmd和post-create-project-cmd
但注意:composer run xxx 这种显式调用的自定义脚本(如 "deploy:clear")不受 --no-scripts 影响——它只管生命周期事件,不管手动 run。
为什么有时候加了 --no-scripts 还在执行脚本?
大概率是脚本没定义在项目根 composer.json 的顶层 scripts 字段里,而是藏在 extra、config 或子包的 composer.json 中。
另一个常见原因是用了插件(比如 hirak/prestissimo 或某些部署插件),它们可能注册了自己的钩子,不走标准 scripts 机制。
- 先确认脚本位置:
cat composer.json | jq '.scripts',看输出是否为空或结构异常 - 检查是否被插件劫持:运行
composer show --plugins,留意是否有 hook 类型插件 - 最彻底的验证方式:临时重命名项目根
composer.json→ 改成composer.json.bak,再跑composer install --no-scripts,如果脚本不执行了,说明原脚本确实在这个文件里
真正容易被忽略的是:脚本执行与否,和 --no-interaction 无关,也和 --quiet 无关——它们只控制输出和交互,不干预脚本逻辑本身。

















