Composer默认下载zip包而非tar包，因PHP内置ZipArchive扩展普及率高、跨平台兼容性好且解压逻辑更成熟；只要包声明dist.type为zip且未强制source模式，就会下载.zip文件。
Composer默认下载zip包，不是tar
Composer 默认走的是 dist 下载路径，且优先选择 zip 格式——只要包声明了 "dist": {"type": "zip", "url": "..."} ，且你没强制切到 source 模式，它就会下载 .zip 文件并解压。这不是“可选配置”，而是底层行为策略。你看到的 Downloading https://example.com/pkg-1.2.3.zip 日志就是证据。
常见误解是认为 tar 更“原生”或更高效，但实际在 PHP 生态中：zip 是 Composer 官方首选格式，因为：
- PHP 内置
ZipArchive扩展普及率高，Windows/macOS/Linux 均开箱即用 -
tar（尤其是.tar.gz）依赖系统tar命令或 PHP 的Phar扩展，在某些容器或精简环境里可能缺失 - Composer 对
zip的校验、解压、权限还原逻辑更成熟，出错时堆栈更明确
为什么有时看到.tar.gz却报ZipArchive::extractTo失败？
错误信息里出现 ZipArchive::extractTo()，哪怕你确认自己配的是 .tar.gz，说明 Composer 在 fallback 阶段仍尝试用 ZipArchive 解压——根源不在包格式，而在 PHP 环境或配置冲突：
- PHP 未启用
zip扩展：运行php -m | grep zip确认；缺失时 Composer 会静默退回到tar流程，但某些校验环节仍调用 ZipArchive 导致报错 - 用了
--prefer-source或全局"preferred-install": {"*": "source"}，结果 Composer 忽略 dist 字段，直接 clone Git，但某些插件或自定义脚本误判为要解压 zip - 私有包没声明
dist.type，Composer fallback 到 source 后又因网络/Git 配置失败，最终抛出 ZipArchive 相关异常（属于误导性堆栈）
查清路径最直接的方式：加 -v 参数运行 composer install -v，盯住每条日志开头是 Downloading 还是 Cloning，再结合 php -i | grep zip 确认扩展状态。
镜像源是否影响 zip/tar 选择？
不影响。镜像源（如阿里云、腾讯云 Composer 镜像）只代理元数据（packages.json）和 dist 包的 HTTP 请求，不干预格式决策。Composer 从 packagist.org 或镜像拿到的 dist 描述里已经固定了 type 和 url，镜像只是原样转发。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
唯一例外是某些老旧私有镜像未同步 dist 字段，或手动上传包时漏填 dist，导致 Composer 只能 fallback 到 source——这属于镜像维护问题，不是格式偏好问题。
验证方式：对比原始源与镜像返回的 https://repo.example.com/p2/vendor/package.json 内容，重点看 dist 节点是否存在且 type 字段值正确。
artifact仓库里放.zip还是.tar.gz？
都可以，但必须严格匹配命名与结构规则，且 .zip 更少踩坑：
- 文件名必须是
{vendor}/{package}-{version}.zip或{vendor}/{package}-{version}.tar.gz——acme/utils-1.2.0.zip✅，utils-1.2.0.zip❌（缺 vendor 子目录） - 解压后根目录必须直接有
composer.json，不能套文件夹；.tar.gz在部分 Linux 环境下解压时默认保留顶层目录，容易多一层，比 zip 更难对齐 - PHP 的
ZipArchive对中文路径、特殊字符容忍度高于Phar或系统tar命令，内网分发时稳定性更高
如果团队混合使用 Windows 和 Linux 构建机，统一用 .zip 可避免因系统工具链差异导致的解压失败。
真正容易被忽略的点：Composer 不校验 ZIP 内容完整性（比如 CRC），只检查文件头和 composer.json 存在性。改过 ZIP 后没删 vendor/ 和 composer.lock，它可能复用旧缓存——这不是 bug，是设计使然。
