如何在composer.json中指定一个包只能从源码安装？（–prefer-source）

可通过配置 "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 安装。如果你是包的维护者：

星绘

豆包旗下 AI 写真、P 图、换装和视频生成

429

查看详情

• 在包的 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 源码安装行为。