生产环境执行 composer install 报错因默认安装 require-dev 包，应使用 --no-dev --optimize-autoloader --no-interaction --no-scripts 参数组合，确保跳过开发依赖、优化自动加载、禁用交互与脚本，并提交 composer.lock 保证依赖一致。
composer install 为什么在生产环境报错 “require-dev” 相关包找不到
因为默认情况下 composer install 会装 require-dev 里的包，但生产服务器通常没装 PHPUnit、PHPStan 这类开发依赖，也压根不需要——它们不仅浪费磁盘和时间，还可能因扩展缺失（比如 ext-xdebug）直接中断安装。
正确做法是加 --no-dev 参数，跳过开发依赖：
composer install --no-dev --optimize-autoloader
-
--no-dev：彻底忽略require-dev字段，不解析、不下载、不安装 -
--optimize-autoloader：生成扁平化类映射（vendor/composer/autoload_classmap.php），减少file_exists()调用，提升加载速度 - 这两个参数必须同时用；只加
--no-dev不优化，autoload 仍走 PSR-4 动态查找，性能损失明显
部署时 composer install 卡住或超时，常见原因和对策
不是网络慢，而是 Composer 默认启用插件和脚本钩子（比如 post-install-cmd），而生产环境常禁用 proc_open、没装 Git、甚至没配好 git 命令路径，导致某些包（尤其是带 install 脚本的 Laravel 包）卡死或报 sh: git: not found。
安全稳妥的部署命令是：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer install --no-dev --optimize-autoloader --no-interaction --no-scripts
-
--no-interaction：避免交互式提示（比如私有包认证），否则部署脚本会挂起等待输入 -
--no-scripts：跳过所有scripts钩子（post-root-package-install、post-install-cmd等），防止执行前端构建、缓存清理等非必要操作 - 如果项目真依赖某个脚本（比如生成配置文件），应把该逻辑抽离到部署流程中单独执行，而不是靠 Composer 自动触发
vendor 目录不该进 Git，但怎么确保部署时版本完全一致
很多人删掉 vendor 提交，却忘了 composer.lock 文件才是关键——它锁定了每个包的精确版本、哈希和源类型（dist / source）。只要 composer.lock 在，composer install 就能复现完全相同的依赖树。
- 务必提交
composer.lock到 Git，且禁止手动修改它 - 上线前在 CI 或本地先跑一次
composer install（带--no-dev），确认vendor/能正常生成，再推composer.lock - 如果线上执行
composer install报Root package '<code>xxx' cannot be installed because it requires thexxxpackage which cannot be found，大概率是composer.json和composer.lock不匹配（比如改了name或version但没重生成 lock）
PHP 版本不一致导致 composer install 失败
Composer 会检查当前 PHP 版本是否满足 config.platform.php 或 require.php 的约束。本地 PHP 8.2 开发，服务器还是 PHP 7.4？那 composer install 会直接退出，并报类似 Your requirements could not be resolved to an installable set of packages 的模糊错误。
查清真实原因的方法是：
composer install --no-dev -v
-
-v（verbose）会打印详细冲突信息，通常末尾会写明 “Packagefoo/barrequires php ^8.1 but your PHP version (7.4.33) does not satisfy that requirement” - 解决方式不是降级本地 PHP，而是统一平台约束：在
composer.json的config下设"platform": {"php": "7.4.33"}，让 Composer 模拟该环境解析依赖 - 注意：
config.platform.php只影响依赖解析，不影响实际运行——PHP 版本不匹配最终还是会 runtime 报错，所以服务器 PHP 版本必须真实达标
最易被忽略的一点：Composer 自身也有 PHP 版本要求。低于 PHP 7.2.5 的环境，连 composer install 命令都执行不了——别急着调项目配置，先看 php -v 和 composer --version 是否兼容。
