该错误表示 Composer 执行的某个脚本（如 php artisan optimize、npm run dev 等）返回非零退出码，并非 Composer 自身故障；需用 composer install -v 定位具体失败脚本，再手动运行复现并排查环境、权限、配置等问题。
为什么 composer install 报 “Script … returned with error code 1”
这个错误本身不是 Composer 自身失败，而是它在执行某个脚本（比如 post-install-cmd、post-update-cmd）时，该脚本进程退出码非 0。常见来源包括：php artisan optimize、npm run dev、phpunit、phpcs 或自定义的 PHP 脚本。Composer 只是“背锅”，真正的问题藏在被调用的命令里。
快速定位具体哪条脚本失败
加 -v（verbose）参数重跑，看最后几行输出：
composer install -v
重点找类似这样的行：
Executing script php artisan optimize [KO]
Script php artisan optimize handling the post-install-cmd event returned with error code 1
一旦锁定脚本，就直接手动运行它，复现并观察真实报错：
- 如果是 Laravel 项目：运行
php artisan optimize（或新版的php artisan config:clear && php artisan cache:clear） - 如果是前端构建：运行
npm run dev或yarn build，看控制台具体错误（如 Node 版本不兼容、缺少node_modules） - 如果是 PHP 代码检查：运行
phpcs --standard=PSR12 app/，可能提示语法错误或扩展未启用
常见脚本失败原因与修复点
多数情况不是 Composer 配置问题，而是环境或依赖状态不一致：
-
php artisan类命令失败：检查.env是否缺失或数据库配置不可达；确认APP_KEY是否已生成（php artisan key:generate） -
npm/yarn脚本失败：确认package.json中脚本定义存在，且本地 Node 版本满足engines.node要求；尝试先npm ci再composer install - PHP 扩展缺失：脚本中用了
ext-gd或ext-mbstring，但 CLI 模式下未启用（php -m | grep gd查看） - 权限问题：比如写
storage/logs失败，确保目录可写（chmod -R 775 storage bootstrap/cache） - 脚本返回非零码但本意是“忽略”：某些老项目会用
phpcs检查并期望失败时不中断，这时需改脚本逻辑或在composer.json中加"stop-on-failure": false（不推荐，应修复根本问题）
绕过脚本执行（临时调试用）
仅用于快速验证是否脚本导致阻塞，**不要长期使用**：
composer install --no-scripts
如果成功，说明 100% 是某条脚本的问题。之后再逐个手动运行 scripts 字段里的命令，定位到具体哪一行。也可临时注释 composer.json 中的 "scripts" 段落再试。
脚本失败的根源往往不在 Composer 配置，而在当前机器的 PHP 环境、Node 状态、文件权限或项目配置的一致性——这些细节容易被 error code 1 的泛泛提示掩盖。
