Composer 中 replace 本身不触发安装，需配合 repositories 声明 fork 地址和 require 指定原包名与 fork 分支（如 "guzzlehttp/guzzle": "dev-main as 7.8.0"）实现透明覆盖，fork 的 composer.json 中加 replace 可防冲突。
在 Composer 中用 replace 处理 forked 包，核心不是靠它“替换安装”，而是配合 repositories 和 require 实现对上游包的**透明覆盖**——让 Composer 认为你装的是原包，实际拉取的是你的 fork 分支。
为什么不能只靠 replace？
replace 本身只是声明“我这个包逻辑上替代了另一个包”，它不会触发下载或安装，也不影响依赖解析的来源选择。单独写 "monolog/monolog": "dev-my-fork" 在 replace 里，Composer 完全无视——它只看 require。
正确做法：三步联动
要真正用上 fork，必须同时配置以下三项：
-
在
repositories中声明你的 fork 地址（类型vcs），让 Composer 知道这个包从哪来 -
在
require中照常写原包名 + 你 fork 的分支或版本号（如"monolog/monolog": "dev-main as 2.10.0"） -
可选但推荐：在 fork 的
composer.json中用replace声明替代关系，避免下游项目重复 require 原包引发冲突
实际配置示例
假设你 fork 了 guzzlehttp/guzzle 到 https://github.com/yourname/guzzle，并在 main 分支做了修改：
你的项目 composer.json：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/yourname/guzzle"
}
],
"require": {
"guzzlehttp/guzzle": "dev-main as 7.8.0"
}
}
你 fork 的 guzzle/composer.json 中建议加上：
"replace": {
"guzzlehttp/guzzle": "self.version"
}
这样别人 require 你的 fork 时，Composer 就知道它已“覆盖”原包，不会因版本重叠报错。
常见陷阱提醒
-
分支名要拼写准确：GitHub 默认是
main，不是master；写错会导致 Composer 找不到分支 -
as 版本必须兼容原包约束：比如原项目 require
"guzzlehttp/guzzle": "^7.2"，你就不能用"dev-main as 6.5.0"，否则依赖不满足 -
别忘了
composer update guzzlehttp/guzzle：改完配置后必须显式更新，否则仍用缓存里的旧版本
基本上就这些。replace 是“声明意图”，真正干活的是 repositories + require 的组合。
