使用 --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 参数来实现这一点。
什么是 --prefer-source？
默认情况下，Composer 为了提升性能，会优先从预打包的 dist（通常是 zip/tar 包）安装依赖。而 --prefer-source 参数告诉 Composer 尽可能从版本控制仓库（如 GitHub 的 git 仓库）克隆源码来安装包。
注意：这仅对托管在 VCS（如 Git）中的包有效，本地路径或私有仓库也需支持源码拉取。如何使用 --prefer-source
在运行 composer install 或 composer require 时加上该参数即可：
-
composer install --prefer-source—— 安装所有依赖时优先使用源码 -
composer require vendor/package --prefer-source—— 只为某个新添加的包使用源码
执行后，你可以在 vendor/ 目录下看到对应包包含完整的 .git 目录，说明它是通过 git 克隆下来的。
适用于哪些场景？
这个参数特别适合以下情况：
-
调试第三方包：可以直接在
vendor/中加日志、断点或临时修改逻辑验证问题。 - 开发自己的包：如果你正在开发一个被多个项目使用的组件，用源码方式可以实时测试变更。
- 贡献开源项目：方便你在本地 fork 并切换到开发分支进行测试或提交 PR。
设置全局行为（可选）
如果你希望所有项目都默认使用源码安装，可以配置 Composer 全局选项：
GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。
composer config -g preferred-install.source true
这会让 Composer 默认以 source 方式安装所有包，无需每次加参数。
若只想对特定类型包生效，比如只对 dev 分支用 source：
composer config preferred-install {"*": "dist", "your-vendor/*": "source"}
基本上就这些。合理使用 --prefer-source 能极大提升开发效率，尤其是在处理复杂依赖或自研组件时。记得在生产环境中避免使用源码安装，确保构建稳定和可复现。
