composer不支持在install或require命令中直接指定别名，别名必须在composer.json的require字段中用“dev-branch as x.y.z”语法声明，且仅影响版本解析，不改变包名、路径或自动加载。
Composer install 时无法直接指定版本别名
你不能在 composer require 或 composer install 命令里用类似 "monolog/monolog:2.0.0 as 1.99.99" 这种写法来“安装时指定别名”——Composer 不支持命令行直接声明 alias。版本别名（alias）是包作者在 composer.json 的 extra.branch-alias 中定义的元信息，或由用户在自己的项目 composer.json 中通过 replace 或 conflict 间接影响解析逻辑，但不是安装参数。
想让 Composer 解析出某个别名版本，得改自己项目的 composer.json
别名生效的前提是：目标包本身声明了 branch-alias（比如 dev-main → 3.0.x-dev），而你的项目又依赖一个能匹配该别名的约束（如 "^3.0"）。若你想强制让某包“看起来像另一个版本”，常见做法是：
- 在自己项目的
composer.json的require中写明具体版本 + 别名语法："vendor/package": "dev-feature-branch as 2.5.0" - 确保该分支真实存在且其
composer.json中有对应extra.branch-alias（否则 alias 无意义） - 别名只影响版本约束解析，不改变实际下载的代码；
dev-feature-branch还是那个分支，只是 Composer 在解决依赖时把它当作2.5.0来比对
示例：你依赖一个尚未发版的 PR 分支，但想让它参与 "^2.5" 的兼容性检查：
"require": {
"php": "^8.1",
"some/lib": "dev-fix-redis-timeout as 2.5.0"
}
alias 写错或缺失会导致依赖解析失败
常见错误现象包括：Could not find package some/lib at version 2.5.0，即使你写了 as 2.5.0 —— 这通常是因为：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 目标分支（如
dev-fix-redis-timeout）根本不存在于源仓库 - 该分支的
composer.json没有声明extra.branch-alias，导致 Composer 不知道它“代表”哪个稳定版本 - 你用了
as但约束条件太宽（如"^2.0"），而 alias 版本（如2.5.0）不满足其他依赖的约束 - 运行
composer update时没加--with-dependencies，导致 alias 未被重新计算
别名不是版本覆盖，也不能绕过 stability-check
即使你写了 "dev-main as 3.0.0"，如果项目 minimum-stability 是 stable，而 dev-main 是开发分支，Composer 仍会报错：Could not find package ... at version 3.0.0。因为 alias 不提升稳定性级别。
真正起作用的是 stability flags（如 @dev）或显式设置 "minimum-stability": "dev"。alias 只是“告诉依赖解析器：这个不稳定版本，在语义化版本层面等价于某个稳定号”，它不改变下载行为、不跳过校验、也不影响 autoloading。
alias 容易被当成“版本伪装”，但它本质是依赖图里的一个映射标记；真要锁定行为，优先用 require 中的精确版本号或 platform 配置补全环境假设。
