使用 Composer 替换原包为 fork 版本需配置 repositories 指向 fork 地址，保持包名与原包一致，并在 require 中使用 "dev-branch as X.Y.Z" 语法进行版本别名映射，最后清除缓存并更新依赖确保生效。
当你在使用 Composer 时，如果需要使用某个开源包的 fork 版本（比如你提交了 PR 或做了自定义修改），但又想让这个 fork 在项目中替代原包，并能正常处理版本约束，就需要正确配置 repositories 和使用 版本别名（version alias）。以下是具体操作方式。
1. 配置 repositories 指向你的 fork
在项目的 composer.json 中添加 repositories 字段，指定你的 fork 地址。注意保留原包的名称（name），这样 Composer 才能正确替换。
示例：
{
"repositories": [
{
"type": "git",
"url": "https://github.com/your-username/package-name-fork"
}
],
"require": {
"original-vendor/package-name": "dev-main as 1.2.3"
}
}
这里假设：
- 原包是
original-vendor/package-name - 你的 fork 仓库地址是
https://github.com/your-username/package-name-fork - 你的 fork 的主分支是
main，你想让它表现得像版本1.2.3
2. 使用版本别名（as）映射 dev 分支到特定版本
Composer 不允许直接用 dev-master 替代稳定版本，除非你明确告诉它“这个开发分支等价于哪个版本”。这就是版本别名的作用。
语法是：
"require": {
"vendor/package": "dev-branch-name as X.Y.Z"
}
例如：
"require": { "monolog/monolog": "dev-main as 2.9.9" }这表示：使用
dev-main 分支，但把它当成版本2.9.9。这样其他依赖该包且要求^2.9.0的组件就能满足。3. 确保 fork 的 composer.json 包名一致
你的 fork 必须保持和原包相同的
name字段，否则无法替代。不要改包名。正确示例（在你的 fork 的
composer.json中）：{ "name": "original-vendor/package-name", "description": "...", "autoload": { ... } }如果你改成
your-vendor/package-name，Composer 会当作一个不同的包，不会替代原依赖。4. 清除缓存并更新依赖
有时 Composer 缓存了旧的版本信息，导致 fork 不生效。执行以下命令：
composer clear-cache composer update original-vendor/package-name确保看到安装的是你的 fork 地址而不是原始仓库。
基本上就这些。关键点是：正确的 repositories 配置 + 保持包名一致 + 使用 as 别名匹配所需版本。这样就能平滑替换原包而不破坏依赖关系。
