dist包下载不完整本质是zip文件被截断，因http响应提前终止或镜像返回截断响应体，导致缓存写入半截文件，解压时才报错；需验证镜像真实生效、清缓存与vendor、换稳定镜像并强制--prefer-dist安装。
dist包下载不完整，本质是文件被截断
Composer 报 Failed to extract、unable to open archive 或解压后缺 src/、composer.json，基本不是网络闪断，而是下载的 zip 文件本身不完整——HTTP 响应提前终止，或镜像源返回了截断的响应体。它不会报“下载失败”，而是把半截 zip 写进缓存，后续解压时才崩。
别信“换镜像就万事大吉”，先确认你用的是哪个镜像
很多人执行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，但实际请求的仍是 https://packagist.org。原因有三：
- 项目级
composer.json中写了"repositories"字段，会覆盖全局配置 - Composer 2.2+ 已弃用
repo.packagist，改用repositories.packagist.org，旧配置静默失效 - Windows 下 Git Bash 可能读
~/.composer/config.json，而composer config -g写的是%APPDATA%\Composer\config.json
验证真实生效地址：运行 composer diagnose，盯住 Repo packagist.org: 这一行；或加 -vvv 跑一次 composer show -p，第一行 Repository: 后面的域名才是真正在用的。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
全量镜像 ≠ 实时同步，新包仍要等5–30分钟
阿里云、腾讯云等所谓“全量镜像”，元数据同步周期仍是 5–30 分钟。刚在 packagist.org 发布的包，立刻 composer require xxx/yyy 必然失败。此时：
- 手动测镜像状态：
curl -I https://mirrors.aliyun.com/composer/p/xxx/yyy.json，HTTP 200 且Last-Modified接近当前时间才算同步完成 - 清元数据缓存（不是
clear-cache）：rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer（路径按你镜像 URL 转义） - 临时切回官方源验证：
composer config -g repositories.packagist.org '{"type":"composer","url":"https://packagist.org"}'，再试composer show xxx/yyy
真正治本：删缓存 + 删 vendor + 换镜像 + 强制 dist
遇到 dist 包损坏，重试没用，必须清理状态再重装：
- 删掉整个
vendor/目录：rm -rf vendor - 清 Composer 全局缓存：
composer clear-cache - 确认镜像已生效（见上一节），并优先选 USTC 或华为云镜像（同步更稳）
- 显式指定安装方式：
composer install --prefer-dist --no-plugins，避免插件干扰和 source fallback 卡死
注意：--prefer-dist 不是默认行为的加强版，而是绕过 git clone 的强制指令——只要包有 dist 归档，就一定走 zip 下载校验流程，SHA256 校验也只在此路径触发。
