执行composer install前必须确认php环境可用、扩展齐全、vendor目录状态干净，否则可能静默失败或报错；需验证php -v≥7.4、php -m含openssl/mbstring/json/phar/curl/zlib/xml/filter/hash/zip、未禁用allow_url_fopen和proc_open，并确保composer.lock存在且完整、vendor干净、网络可访问packagist镜像。
执行 composer install 前，不是“有 composer 就能跑”，而是必须确认三件事：PHP 环境可用、扩展齐全、vendor 目录状态干净。缺一环，命令可能静默失败或中途报错，比如卡在 failed to extract 却不提示缺 zip 扩展。
PHP 版本与基础运行环境是否就绪
Composer 本身是 PHP 脚本，composer install 实际由 PHP 解释执行。所以第一步不是敲命令，而是验证：
-
php -v输出版本 ≥ 7.4（Laravel 10+ 要求 ≥ 8.1；Yii 3 要求 ≥ 8.0） -
php -m中必须包含openssl、mbstring、json、phar、curl、zlib、xml、filter、hash、zip—— 少任意一个，都可能在拉包、解压、校验签名时崩溃，且错误信息极其模糊 - 确保
php.ini中未禁用allow_url_fopen或disable_functions里没屏蔽proc_open（Composer 解压和脚本执行依赖它）
项目目录下是否有 composer.lock 和 vendor/ 的合理状态
composer install 的本质是“按 lock 文件还原依赖”，不是“重新解析依赖树”。这意味着：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须存在
composer.lock文件，且内容完整（不能是空文件或只有一行） - 如果
vendor/已存在，但里面混着开发时手动require的包或旧版本，install可能跳过重装，导致行为不一致 - 生产环境部署前，建议先
rm -rf vendor composer.lock，再composer install --no-dev --optimize-autoloader—— 否则可能残留phpunit等 dev 包，或 autoloader 未优化
网络与 Packagist 访问是否通畅
即使本地有 composer.lock，install 过程仍需访问 Packagist（或镜像）获取包元数据、校验哈希、下载 zip/tar.gz 归档。常见断点：
-
https://repo.packagist.org/packages.json返回 403 或超时 → 检查是否被墙，或公司代理未配置；可临时切国内镜像：composer config -g repo.packagist composer https://packagist.phpcomposer.com - 下载包时提示
failed to open stream: HTTP request failed!→ 多半是curl扩展缺失或 SSL 证书路径不对（Windows 常见），可加-vvv查看详细请求地址和错误 - 解压失败报
unable to decompress gzipped phar archive→ 不是网络问题，是zlib或zip扩展未启用
最容易被忽略的其实是权限和上下文：在 Docker 容器或 CI 环境中运行 composer install 时，当前用户对 vendor/ 和 composer.lock 必须有写权限；而 Laravel 部署时，若 storage/ 和 bootstrap/cache/ 不属于 web server 用户（如 www-data），后续 config:cache 会失败——这些都不是 composer install 报的错，但根源在此。
