--prefer-dist没效果是因为它不是强制开关，而是优先尝试策略：包无dist字段、lock记录source、dev/path类型依赖或镜像未配对时均会静默fallback到source；需结合-v日志验证、项目级配置及镜像优化才能确保生效。
为什么加了--prefer-dist有时没效果？
它不是强制开关，而是“优先尝试下载 dist 归档”的提示。Composer 会先查包的 composer.json 是否声明了 dist 字段（含 url 和 sha256），有就下压缩包；没有就静默 fallback 到 --prefer-source 行为，你根本看不到报错。
-
dev-master、dev-feature/x、path类型仓库默认不提供dist，加了也白搭 - 私有 GitLab/GitHub Enterprise 仓库若没启用 archive 功能，
dist字段为空，--prefer-dist自动失效 - 如果
composer.lock里记录的是 source 安装方式（比如上次用了--prefer-source），这次即使加参数，也可能沿用旧记录
--prefer-dist真正起效的典型场景
它只在特定环境约束下才成为“必要项”，而不是“随便加就快”：
- CI/CD 流水线中：构建机常无 Git、无 SSH key、无 GitHub token，
--prefer-dist是唯一能稳定完成安装的方式 - Docker 构建阶段：基础镜像（如
php:alpine）默认不装 Git，--prefer-dist避免Cloning into 'vendor/xxx'卡死 - 只读文件系统部署（如某些 PaaS）：不能写
.git目录，--prefer-source直接失败 - 本地首次安装大型项目（如 Laravel + SDK 套件），且所有依赖都打了正式 tag：能明显缩短 vendor 解压前等待时间
怎么确认当前是否真走 dist 流程？
别靠猜，看日志最准：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 加
-v运行：composer install -v，观察输出里是否有Downloading <code>xxx.zipfrom https://... - 如果看到
Cloning <code>https://github.com/xxx，说明走了 source - 检查配置：
composer config --list | grep preferred-install，确认没被项目或全局设成source - 临时覆盖：
composer install --prefer-dist能绕过配置，但不会写入composer.json
项目级配置比全局配置更安全
全局设 preferred-install 容易翻车——比如你本地设成 source，同事拉代码后 composer install 就默默 clone 所有包，CI 也跟着慢。
- 删掉全局设置：
composer config -g --unset preferred-install - 在项目
composer.json的config段加："config": { "preferred-install": "dist" } - 精细控制可写对象形式：
"config": { "preferred-install": { "myorg/*": "source", "*": "dist" } }，自家包走源码，第三方包全走 dist
实际安装方式永远是命令行参数、包自身声明、网络可用性三者叠加的结果，--prefer-dist 只是把“快的路径”暴露出来，前提是你得先配对镜像源和网络环境。
