可通过配置 "preferred-install" 实现按包指定源码安装:在 composer.json 的 config 中设置,如 "myorg/private-lib": "source",并确保该包提供 VCS 源信息。

在 composer.json 中无法直接强制某个包“只能从源码安装”,因为 --prefer-source 是 Composer 的全局命令行选项,不是 per-package 配置项。但你可以通过几种方式间接实现类似效果。
使用 preferred-install 配置(推荐)
这是最接近你需求的方法:在项目根目录的 composer.json 中设置 "preferred-install",按包名或通配符指定安装方式。
- 支持精确匹配(如
"vendor/package")、通配符(如"vendor/*")或全局默认("*") - 值为
"source"表示优先走 Git 克隆(即等效于--prefer-source对该包生效)
示例:
{
"config": {
"preferred-install": {
"myorg/private-lib": "source",
"monolog/monolog": "dist",
"*": "dist"
}
}
}
这样,myorg/private-lib 每次 install/update 都会尝试从源码安装(前提是它有可用的 VCS 信息,如 git 地址),其他包走 dist。
确保包本身提供源码信息
Composer 只有在包的 composer.json 中声明了 source(即 "type": "vcs" 或包含 "source" 字段)时,才能用 --prefer-source 安装。如果你是包的维护者:
- 在包的
composer.json中确保有有效的"source"或托管在支持的 VCS(如 GitHub、GitLab)上 - 不要只发布
dist归档(如 zip/tar),否则即使设了preferred-install,Composer 也会 fallback 到 dist
避免依赖缓存干扰
Composer 缓存可能让本该走 source 的包“悄悄”用了 dist 归档。可临时清缓存验证:
composer clear-cache- 再运行
composer install或composer update myorg/private-lib - 检查
vendor/myorg/private-lib/.git是否存在,存在即说明是 source 安装
不推荐:全局强制 --prefer-source
虽然可以每次执行 composer install --prefer-source,但这会影响所有包,且无法写进 composer.json 自动生效。不适合“仅对某包”的场景,也容易被团队成员忽略。
基本上就这些。核心要点是:preferred-install + 包本身支持 VCS 源码地址 = 可控的 per-package 源码安装行为。










