composer install 默认执行脚本是设计行为,因脚本被视为安装流程自然延伸;--no-scripts 仅跳过 composer.json 中明确定义的脚本及绑定的标准事件,不生效时多因插件绕过或脚本来源误判。

composer install 为什么还会跑脚本
默认情况下 composer install 会执行 post-install-cmd、pre-autoload-dump 等脚本,哪怕你没手动加 --scripts。这不是 bug,是 Composer 的设计逻辑:它把脚本当作安装流程的自然延伸。
常见错误现象:composer install --no-scripts 仍触发某些钩子,比如 Laravel 的 php artisan optimize:clear 还在跑——那大概率是因为脚本被写进了 scripts 段且绑定了 post-install-cmd,而 --no-scripts 只跳过 *所有* 脚本,但部分插件或自定义 installer 可能绕过该开关(比如通过事件监听器直接调用)。
-
--no-scripts是唯一标准方式,别信--skip-scripts或--disable-scripts(不存在) - 如果项目用了
composer-plugin-api>=2.0 的插件(如laravel-shift/composer-installer),它们可能无视--no-scripts,得看插件文档是否支持COMPOSER_NO_SCRIPTS=1环境变量 - CI/CD 中建议统一用
COMPOSER_NO_SCRIPTS=1 composer install,比命令行参数更稳定
哪些脚本会被 --no-scripts 真正跳过
--no-scripts 只影响 composer.json 里 scripts 下明确定义的命令,以及它们绑定的标准事件(如 post-install-cmd、pre-autoload-dump)。不会影响:
- Autoloader 生成本身(那是 Composer 核心行为,和脚本无关)
- 第三方插件自己注册的事件监听器(除非插件主动检查
COMPOSER_NO_SCRIPTS) -
require-dev包里的脚本(只要没被主项目的scripts显式调用,就不会跑)
典型场景:本地开发想快速装包不跑 php artisan migrate:fresh,或 CI 构建时避免因缺少 DB 配置导致 post-update-cmd 失败。
遇到 --no-scripts 不生效怎么办
先确认是不是脚本根本不在 scripts 里,而是由插件硬编码触发。运行 composer install -v,看日志里执行的是 Executing script 还是 Running plugin X。
- 如果是插件行为,查该插件是否读取
COMPOSER_NO_SCRIPTS环境变量;不支持就只能临时删掉composer.json中对应插件配置 - 检查是否有
composer.lock里记录了旧版本依赖,其安装器自带脚本逻辑;可尝试rm composer.lock && composer install --no-scripts - 极少数情况是
vendor/bin下二进制被其他工具(如roave/better-reflection)自动调用,和 Composer 无关,得查调用链
替代方案:只禁用特定脚本而非全部
Composer 原生不支持“跳过某一个脚本”,但可通过环境变量 + 脚本内判断实现软跳过:
"scripts": {
"post-install-cmd": [
"@php -r \"if (getenv('SKIP_MIGRATE')) exit;\" && php artisan migrate:fresh --no-interaction"
]
}这样就能用 SKIP_MIGRATE=1 composer install 精准控制,比全局 --no-scripts 更安全——尤其当其他脚本(如生成 autoload、清理缓存)仍需执行时。
真要跳过脚本,--no-scripts 是唯一直接手段;但“不生效”往往不是它的问题,而是脚本来源被误判了。










