composer下载包不完整本质是zip被截断写入缓存，解压时才暴露；必须清缓存、删vendor、换稳定镜像（如华为云）、强制--prefer-dist，且需验证镜像真实生效、清理元数据缓存、确保php扩展启用。

Composer 下载包不完整，不是网络闪断或“运气不好”，而是 zip 文件被截断后写入缓存，解压时才暴露问题——Failed to extract、unable to open archive、解压后缺 src/ 或 composer.json 都是典型症状。必须清缓存 + 删 vendor + 换镜像 + 强制 --prefer-dist，重试没用。

怎么确认你真在用国内镜像？

很多人以为执行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就生效了，其实不一定：

• 项目级 composer.json 里写了 "repositories" 字段，会直接屏蔽全局配置
• Composer 2.2+ 已弃用 repo.packagist，改用 repositories.packagist.org，旧命令静默失效
• Windows 下 Git Bash 和 CMD 可能读取不同路径的 config.json（~/.composer/config.json vs %APPDATA%\Composer\config.json）

验证真实生效源：运行 composer diagnose，盯住 Repo packagist.org: 这一行；或者加 -vvv 跑一次 composer show -p，第一行 Repository: 后面的域名才是真正在用的。

为什么清 composer clear-cache 不管用？

composer clear-cache 只删 dist 包和 zip 缓存，不碰元数据——而镜像同步延迟导致的“找不到包”或“下载错包”，根源在 packages.json 和 provider-*.json 这些元数据文件上。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 真正要删的是元数据缓存目录：rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer（路径按你实际镜像 URL 转义）
• Windows 用户对应路径是：%APPDATA%\Composer\Cache\repo\https---mirrors.aliyun.com-composer
• 删完再跑 composer show xxx/yyy，才能强制拉新元数据

换哪个镜像更稳？

阿里云、腾讯云镜像虽快，但同步周期仍是 5–30 分钟，新包容易“查不到”。华为云镜像明确声明“每 5 分钟同步一次”，USTC 镜像同步日志公开可查，稳定性更高。

• 全局切华为镜像：composer config -g repositories.packagist.org '{"type":"composer","url":"https://mirrors.huaweicloud.com/repository/php"}'
• 临时切官方源验证：composer config -g repositories.packagist.org '{"type":"composer","url":"https://packagist.org"}'
• 别用已停服的旧镜像（如 packagist.phpcomposer.com），它现在返回 404，但 Composer 不报错，只卡死

装包时怎么绕过损坏风险？

--prefer-dist 不是“加速选项”，而是强制走 zip 下载 + SHA256 校验的唯一路径。默认行为可能 fallback 到 git clone，一旦中间出错就无校验。

• 显式加参数：composer require monolog/monolog --prefer-dist
• 设为全局默认：composer config --global prefer-stable true + composer config --global preferred-install dist
• 如果仍报 Corrupted zip file，说明缓存或镜像已污染，必须删 vendor/ + 清元数据缓存 + 换镜像，三步缺一不可

最易被忽略的点：PHP CLI 必须启用 openssl、mbstring、json 扩展，否则 composer.phar 会直接退出，不提示缺失，只报“损坏”——先跑 php -m | grep -E "openssl|mbstring|json" 确认再排查镜像。