composer install 报“Your requirements could not be resolved”不是网络或依赖冲突问题，而是本地PHP版本、缺失扩展（如ext-mbstring）或config.platform配置与composer.lock锁定环境不匹配所致，需优先运行composer diagnose、php -v和php -m排查。
composer install 为什么有时报错却和网络无关
它不是在“下载失败”，而是在做精确还原——只要 composer.lock 里某条记录与当前环境不匹配，就会立刻中止。常见但容易被误判的报错包括：
-
Your requirements could not be resolved：不是依赖冲突，是 PHP 版本、扩展（如ext-mbstring）、或config.platform声明与实际环境不符 -
Could not find package xxx at version yyy：该版本已被作者从 Packagist 下架，或你配置了私有源但当前不可达 - 静默失败（vendor/ 生成但 autoload 不生效）：
composer.json中包名末尾多空格、大小写拼错，install 不校验，但后续php artisan或类加载直接崩
排查优先级：先运行 composer diagnose，再检查 php -v 和 php -m，最后确认 composer.lock 是否完整提交到 Git。
CI/CD 脚本里只允许这一种写法
生产部署和自动化流程中，composer install 必须带固定参数组合，否则等于放弃稳定性保障：
-
--no-dev：跳过require-dev中所有包（如 PHPUnit、PHPStan），避免污染生产镜像 -
--optimize-autoloader（可简写为-o）：生成扁平化类映射，提升 APCu 等 opcode 缓存命中率 - 绝不加
--ignore-platform-reqs：它绕过的是真实环境缺陷，不是网络问题；加了之后跑起来大概率在 runtime 报错 - 不混用
composer update：CI 里一旦出现 update，lock 文件就失效，上线版本不可控
标准命令就是：composer install --no-dev --optimize-autoloader
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
本地重装 vendor 目录时别乱用 --force
删掉 vendor/ 后执行 composer install 是最快恢复方式，但以下操作会引入隐患：
- 加
--force：已废弃参数，新版 Composer 直接报错；旧版强行覆盖可能破坏 autoloader 结构 - 漏掉
-o：开发机上无所谓，但若后续启用了 OPCache，未优化的 autoload 会导致大量文件 stat 调用，响应变慢 - 没清缓存就重装：
composer clear-cache应在换 PHP 版本或切换镜像后手动触发，否则可能复用旧包哈希校验失败
推荐流程：rm -rf vendor/ && composer clear-cache && composer install -o
为什么有时候 install 比 update 还慢
表面看 install 只是“照单抓包”，但它默认执行三项不可跳过的重量级操作：
- 逐个校验
composer.lock中每个包的 SHA256 哈希值（哪怕包已缓存） - 解压每个包并写入
vendor/，I/O 密集型操作 - 重建整个 autoloader 映射，尤其当 lock 文件含上百个小工具包（如前端构建链相关）时更明显
真正提速手段只有三个：composer install --no-dev -o + 确保 cache-dir 在 SSD 上 + 提前配置国内镜像源（如阿里云：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/）
