composer安装中断后不能直接重试，因其会残留部分解压的vendor目录、未完成的composer.lock、损坏的缓存zip包及卡住的git克隆，导致checksum失败、类找不到或静默跳过依赖。
直接删 composer.phar 和 ~/.composer 不够，安装中断后残留的缓存、锁文件、临时解压物、甚至 shell hash 都可能让后续重装失败或行为异常。
为什么 composer install 中断后不能直接重试
Composer 在安装过程中会写入多个临时状态：部分解压的 vendor/ 子目录、未完成的 .lock 写入、~/.composer/cache/files/ 下半截 zip、以及 ~/.composer/cache/vcs/ 里卡在 fetch 中的 Git 克隆。这些“半成品”不会自动清理，下次运行 composer install 时，它会尝试复用损坏的缓存或跳过已存在的目录，导致 checksum 失败、类找不到、或静默跳过依赖。
常见现象包括：
Failed to extract vendor/package: unable to decompress archive-
Class XXX not found（但vendor/autoload.php已存在） -
composer install卡在Loading composer repositories或Installing dependencies不动
先停掉所有 Composer 进程再清理
执行清理前必须确保没有 composer 进程在后台跑，否则可能删到一半被写入，触发缓存损坏。Linux/macOS 上运行：
ps aux | grep composer | grep -v grep
如果看到活跃进程，用 kill -9 PID 杀掉。Windows 用户可打开任务管理器，结束所有 php.exe 进程（Composer 本质是 PHP 脚本）。
接着验证缓存目录是否被占用：
- Linux/macOS：
lsof +D $(composer config --global cache-dir) - Windows：用
Process Explorer搜索Composer\Cache路径
有输出就说明被占用，别硬删。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
按路径逐级清理残留
中断安装最常污染的是缓存和项目本地状态，优先处理这两块：
- 清 Composer 全局缓存：
composer clear-cache（安全，推荐首选） - 手动删项目级残留：
rm -rf vendor/ composer.lock（Linux/macOS）或rmdir /s vendor && del composer.lock（Windows） - 删缓存中易损坏的子目录（比全量清更精准）：
rm -rf ~/.composer/cache/files/* ~/.composer/cache/vcs/*（只清下载包和 Git 缓存，保留元数据） - 检查项目根目录是否有
composer.phar或.composer/（旧版遗留），一并删除
注意：composer clear-cache 不会动 vendor/ 或 composer.lock，所以这两项必须手动删——这是很多人重试失败的关键漏点。
权限与环境干扰常被忽略
中断安装后，如果曾用 sudo composer install，缓存目录下部分文件可能属 root，导致普通用户后续无法写入或清理。此时运行：
sudo chown -R $USER:$USER ~/.composer/cache
然后才能安全执行 composer clear-cache。
另外检查 shell 是否缓存了错误路径：
- 运行
hash -d composer（Linux/macOS）或hash -r（Windows PowerShell）刷新命令哈希 - 确认
~/.bashrc或~/.zshrc没有alias composer=...覆盖原命令 - 临时绕过所有配置测试：
php -d extension=openssl.so $(which composer) install（强制启用必要扩展）
真正卡住的往往不是缓存本身，而是中断时留下的半解压目录或权限错乱——它们不会报错，但会让 composer install 行为不可预测。
