vendor目录不完整时，应删空整个vendor再运行composer install——前提是composer.lock存在且未被修改；否则composer会执行增量更新而非完整安装，导致缺失包无法补全。
vendor 目录不完整时，直接删空 vendor/ 再跑 composer install 是最可靠的做法 —— 前提是 composer.lock 存在且未被修改。
为什么 composer install 有时不补缺失的包
Composer 默认只在 vendor/ 完全为空（连目录都不存在，或是个空文件夹）且 composer.lock 存在时，才执行「完整安装」；否则它会走「增量更新」逻辑，跳过已存在但内容不全的包。
- 常见现象：
vendor/myorg/mylib/被手动删了子目录，但vendor/还在 →composer install不重建它 - 根本原因：Composer 认为“该包已安装”，不会校验其内部文件完整性
- 验证方式：运行
ls -la vendor/myorg/mylib，如果目录存在但里面没src/或composer.json，就属于“伪存在” - 绕过办法：用
rm -rf vendor/myorg/mylib彻底删除该包目录，再运行composer install—— lock 文件会驱动它精准补回
composer update vendor/package-name 为什么经常失效
这个命令本质是「更新」，不是「恢复」。它只在 composer.json 中该包的版本约束发生变更，或 composer.lock 中记录的版本低于当前解析结果时才会触发下载。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 典型失败场景：
composer.lock已锁死"monolog/monolog": "2.9.1"，而composer.json写的是"^2.0"→composer update monolog/monolog直接跳过，不拉包也不报错 - 子依赖不会自动同步：比如
psr/log可能仍卡在旧版，导致运行时报Class not found - 真正想“重拉”，应先清缓存：
composer clear-cache，再删对应包目录，最后composer install
补全前必须确认的三件事
跳过这些检查，composer install 很可能失败或装出错误版本。
-
composer.lock必须存在且未被 git 标为 modified（尤其注意 Windows/Linux 换行符差异） - 执行用户对项目根目录、
vendor/和~/.composer/cache都有读写权限；避免用sudo启动，否则后续操作易因权限错乱中断 - PHP 版本需 ≥
composer.lock中platform.php字段值（如"php": "8.1.10"），否则某些 polyfill 包会选错实现
离线环境或缓存损坏时的特殊处理
如果 composer install 报 Failed to extract 或卡在 downloading，大概率是缓存损坏，而非 vendor 本身问题。
- 优先执行
composer clear-cache，再删vendor/，最后composer install - 离线服务器上不能运行
composer install—— 它仍需访问 packagist.org 获取元数据；正确做法是在有网机器上执行composer install --no-dev --prefer-dist --no-interaction --no-plugins --no-scripts，打包vendor/后传过去 - 解压后若报
Class not found，别急着重装，先跑composer dump-autoload --optimize—— 这步不联网，只刷新自动加载映射
最常被忽略的点：不是删得不够狠，而是删得不够干净 —— 留下一个空 vendor/ 目录，就足以让 Composer 放弃完整安装流程。真正有效的“补全”，始于 rm -rf vendor，止于 composer install 成功退出。
