composer install 不能批量安装新包，因为它只按 composer.lock 还原依赖，不解析 composer.json 新增的 require 条目；正确做法是用 composer require --no-update 多次添加后统一 update，或直接编辑 composer.json 再执行 composer update。
composer install 本身不能同时安装多个新包——它只按 composer.lock 里锁定的版本还原依赖，不解析 composer.json 新增的 require 条目。
为什么 composer install 加包名会报错
常见错误是执行类似 composer install foo/bar baz/qux，这直接失败，因为 composer install 不接受包名参数。它的作用域就是「还原」，不是「添加」。
-
composer install只读composer.lock，哪怕你刚手动往composer.json的require里加了 10 个包，它也完全无视 - 想让新包生效，必须先写入
composer.json，再触发依赖解析和下载——这个动作由composer update或composer require完成 - 硬塞包名给
install命令，PHP 解析器会把它当选项处理，报Unknown option或Too many arguments
批量加包的两种可靠做法
真要一次引入多个包，得绕过 install，用更底层的动作组合：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 逐个
composer require --no-update foo/bar、composer require --no-update baz/qux，最后统一composer update --no-interaction—— 避免每次 require 都重算依赖树，快且可控 - 直接编辑
composer.json的require字段，把多个包 JSON 格式写进去，再跑composer update --no-interaction—— 适合脚本化或 CI 流水线中预置依赖 - 别用
composer require foo/bar baz/qux这种写法：它会被当成一个包名foo/bar baz/qux，必然报Could not find package
一键部署脚本怎么写才真正生效
很多人把清理缓存、迁移数据库这些命令塞进 post-install-cmd，结果上线就静默失败——因为生产环境默认禁用脚本（--no-scripts 是隐式行为）。
- 部署时必须显式启用：
composer install --no-dev --optimize-autoloader --no-interaction后，再补一句composer run-script deploy:post-install -
scripts必须定义在composer.json根层级，不能嵌套在extra或其他字段里；名字随便起，但触发靠composer run-script xxx - 权限问题常被忽略：比如
php artisan cache:clear在部署用户下执行，但storage/目录属主是 www-data，得提前加chown -R www-data:www-data storage/ - 避免在脚本里写死路径，用
php -r "echo getenv('APP_ENV') ?: 'prod';"动态判断环境，否则测试环境跑 deploy 脚本可能误删生产配置
deploy 脚本里哪些命令不能省
看似只是顺序执行几条命令，但漏掉任意一个都可能让部署后服务异常：
-
--no-dev：不装require-dev里的包，减少体积和攻击面；但若脚本里调用了 phpunit，就得单独拎出来用composer global require或改用composer run-script xxx --no-dev控制范围 -
--optimize-autoloader：生成 classmap，跳过 PSR-4 文件查找，对性能提升明显；没它，Laravel 模板渲染可能慢 20%+ -
--no-interaction：防止卡在 license 确认或交互式 prompt 上，CI/CD 必加 -
composer dump-autoload --classmap-authoritative和--optimize是两回事：前者强制只走 classmap，后者是旧版优化开关，现在推荐前者
最易被忽略的点：脚本里调用的命令（如 php artisan）依赖当前 PHP 版本和扩展，而 composer install 不校验运行时环境——上线前得单独验证 php -v、php -m | grep mbstring 这类基础项。
