使用 --prefer-source 参数可让 Composer 优先从 Git 等版本控制仓库克隆源码安装依赖，而非下载压缩包。执行 composer install --prefer-source 或 composer require vendor/package --prefer-source 后，vendor 目录下的包将包含完整 .git 信息，支持直接修改、调试第三方库、开发自研组件或参与开源贡献。该方式适用于需频繁调整依赖代码的场景，可通过 composer config -g preferred-install.source true 设置全局默认，或按厂商配置精细控制。生产环境应避免使用以确保部署稳定性和可复现性。
当你在开发 PHP 包或调试依赖时，经常会希望直接从源码（source）安装 Composer 包，而不是使用压缩包（dist）。这样你可以直接修改依赖代码、查看 git 历史、切换分支，甚至提交更改。Composer 提供了 --prefer-source 参数来实现这一点。
默认情况下，Composer 为了提升性能，会优先从预打包的 dist（通常是 zip/tar 包）安装依赖。而 --prefer-source 参数告诉 Composer 尽可能从版本控制仓库（如 GitHub 的 git 仓库）克隆源码来安装包。
注意：这仅对托管在 VCS（如 Git）中的包有效，本地路径或私有仓库也需支持源码拉取。在运行 composer install 或 composer require 时加上该参数即可：
composer install --prefer-source —— 安装所有依赖时优先使用源码composer require vendor/package --prefer-source —— 只为某个新添加的包使用源码执行后，你可以在 vendor/ 目录下看到对应包包含完整的 .git 目录，说明它是通过 git 克隆下来的。
这个参数特别适合以下情况：
vendor/ 中加日志、断点或临时修改逻辑验证问题。如果你希望所有项目都默认使用源码安装，可以配置 Composer 全局选项：
composer config -g preferred-install.source true
这会让 Composer 默认以 source 方式安装所有包，无需每次加参数。
若只想对特定类型包生效，比如只对 dev 分支用 source：
composer config preferred-install {"*": "dist", "your-vendor/*": "source"}
基本上就这些。合理使用 --prefer-source 能极大提升开发效率，尤其是在处理复杂依赖或自研组件时。记得在生产环境中避免使用源码安装，确保构建稳定和可复现。
以上就是如何强制Composer从源(source)而不是dist安装_--prefer-source参数用于开发和调试的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
124
收藏
