--prefer-dist并非强制下载压缩包，而是优先使用https zip/tar包（如github releases），无有效dist.url时静默回退source；验证需查-v输出、.git目录缺失及composer show -s中非空https dist url。
--prefer-dist 不是强制下载压缩包，而是告诉 Composer：“有现成的 ZIP/TAR 就用它，没有就老老实实 git clone”。 它只在包提供了有效的 dist.url（通常是 HTTPS 指向 GitHub Releases 或 Packagist 归档）时才真正生效；否则静默回退到 source 模式。很多 CI 构建卡在 Cloning into 'vendor/xxx'，不是参数没加，而是根本没 dist 可下。
怎么确认 --prefer-dist 真正起效了
别只看命令里有没有写 --prefer-dist，得验证实际行为：
- 加
-v运行：composer install -v，输出中出现Downloading https://.../archive/...且无Cloning或git clone字样 - 检查
vendor/xxx目录：没有.git文件夹，基本可断定是 dist 模式 - 运行
composer show -s vendor/package，看输出中dist字段是否非空，且url是 HTTPS ZIP/TAR 链接（不是git@github.com:这类 SSH 格式）
为什么加了 --prefer-dist 还在 git clone
这不是参数失效，而是 Composer 自动 fallback —— 因为 dist 条件不满足：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 依赖约束写的是
"dev-main"或"dev-master"，没打正式 tag，Packagist 就没法生成dist信息 -
composer.json中该包被显式设为"source": {}，且没配对应dist - 本地
vendor/xxx已存在且是 source 模式，而composer.lock未更新，Composer 复用旧目录 - 设置了环境变量
COMPOSER_PREFER_SOURCE=1，它优先级高于命令行参数 - 私有包没在仓库配置
archive，或没发布 GitHub Release，导致dist.url为空
怎么稳住 dist 模式（尤其在 CI/CD 中）
靠临时加参数不够可靠，项目级或全局配置更可控：
- 项目级控制（推荐）：在
composer.json的config段加"preferred-install": { "*": "dist" }，比每次敲命令更稳定 - 混合策略（最实用）：
"preferred-install": { "myorg/*": "source", "*": "dist" }，自家私有包保留 git，第三方全走压缩包 - CI 脚本中组合使用：
composer install --prefer-dist --no-dev --optimize-autoloader，三者配合压榨效率 - 注意通配符顺序：
"*": "dist"必须放在最后，否则会覆盖前面的规则；匹配是按包名前缀，"monolog"不匹配monolog/monolog，得写"monolog/"
最容易被忽略的一点：dist 下载失败往往不是参数问题，而是链路层——比如 dist.url 被误写成 git@github.com: 这种 SSH 格式，必须是 HTTPS；或者构建机网络能通 Packagist 但无法访问 GitHub Releases 域名。这时候盯参数没用，得查 URL 格式和网络可达性。
