Composer 的 package alias 是用于 fork 替换场景的版本映射机制，格式为 “dev-branch as X.Y.Z”，仅在 repositories vcs 源中生效，使开发分支兼容原包依赖约束。
什么是 Composer 的 package alias（包别名）
Composer 本身不支持给已发布包“起别名”这种操作，比如把 monolog/monolog 叫成 my/log —— 这不是 Composer 的设计目标。所谓“alias”，实际只在一种场景下生效：当你 fork 一个包并修改后，想让它兼容原包的依赖声明。例如项目依赖 symfony/console:^5.4，但你用了自己 fork 的 my-fork/console，就需要用 replace + provide 或 repositories 配合 alias 来“冒充”原包。
如何用 repositories + package alias 替换依赖
这是最常见、也唯一被 Composer 官方支持的 alias 使用方式。核心是：在 composer.json 中添加自定义仓库，并在该仓库定义中用 alias 指向某个具体 commit 或分支的版本号。
-
repositories必须是vcs类型（如 git），且 URL 指向你的 fork 仓库 -
alias不是独立字段，而是写在require中的版本约束里，格式为"dev-main as 2.0.0" - 这个
as后面的版本号，必须和原包在其他依赖中声明的版本约束匹配（比如别人 require"some/package": "^2.0"，你就得 alias 成2.0.0或2.0.999） - 注意：alias 只对当前 require 生效，不会影响全局包名解析
示例：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/yourname/some-package"
}
],
"require": {
"some/package": "dev-main as 2.0.0"
}
}
为什么 composer require some/package:dev-main –no-update 然后手动改 version 不行
因为 Composer 在安装时会校验包的 version 字段与实际 tag/commit 是否一致。如果你在 fork 的 composer.json 里硬写 "version": "2.0.0"，但没打对应 tag，composer install 会报错：Could not find package some/package with version 2.0.0。更糟的是，即使绕过校验，也会导致 autoload、autoload-dev 和 metadata 解析异常。
