composer install 不会清理损坏的 vendor 目录，因其仅依据 composer.lock 执行确定性安装，不校验文件完整性、不删除残缺包；需手动执行三步清理法：删除 vendor 和 lock、清缓存、重装并验证。
直接运行 composer install 通常无法修复已损坏的 vendor/ 目录——它只按 composer.lock 安装，不校验文件完整性，也不会删除残缺包。
为什么 composer install 不会清理坏掉的 vendor
Composer 的设计逻辑是「确定性安装」：只要 composer.lock 存在且未改动，install 就跳过依赖解析，仅解压/软链已记录的包版本。它不会检查 vendor/autoload.php 是否可读、vendor/symfony/console 是否缺了 Command.php，更不会主动删掉半截写入失败的目录。
常见错误现象包括：Class not found 却确认类名拼写无误、require(): failed to open stream 指向 vendor 内路径、autoload.php 报语法错误（因被截断或写入失败）。
- 使用场景：CI 构建中断、磁盘空间不足导致
composer update崩溃、手动删改过vendor/下部分子目录 - 性能影响：盲目重装可能拉取大量重复包，尤其在没配
COMPOSER_CACHE_DIR时 - 兼容性注意：PHP 8.2+ 下某些旧版 Composer 插件可能在清理阶段报
Deprecated: Return type，但不影响主体流程
真正有效的三步清理法
核心思路：先彻底清空不可信状态，再用锁文件重建，最后验证关键入口。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 删掉整个
vendor/和composer.lock（⚠️仅当确定要严格复现线上环境时保留 lock；否则删 lock 可触发最新兼容版本重解析） - 运行
composer clear-cache—— 清掉本地缓存里可能损坏的 zip 包，避免重装时复用坏包 - 执行
composer install --no-dev --optimize-autoloader（生产环境加这两个参数；开发环境可去掉--no-dev）
示例：
rm -rf vendor composer.lock composer clear-cache composer install --no-dev --optimize-autoloader
完成后立刻验证：php vendor/autoload.php 应静默无输出；php -m | grep mbstring 确保扩展依赖没漏（有些包如 symfony/polyfill-mbstring 会动态检测）。
遇到「package not found」或「signature mismatch」怎么办
这通常不是 vendor 损坏，而是 packagist 元数据同步问题或私有仓库配置失效。
- 先试
composer diag：它会检查签名、CA 证书、网络连通性，输出类似Checking composer.json: OK或Warning: The lock file is not up to date - 若提示
file could not be downloaded: SSL operation failed，临时加-vvv查具体域名，再检查composer config -g repo.packagist.org是否被篡改 - 私有包报错？确认
auth.json在项目根目录或COMPOSER_HOME下，且 token 未过期（composer config -g github-oauth.github.com可查）
最易被忽略的是：某些 IDE（如 PHPStorm）会后台扫描 vendor/ 并锁定文件，导致 rm -rf vendor 失败却无提示。遇到删不干净，先关掉 IDE 再试。另外，Windows 下长路径或 NTFS 权限异常也会让 composer install 静默跳过子目录——此时必须用 robocopy /purge 或 PowerShell 的 Remove-Item -Recurse -Force 才能清透。
