Composer 的 version alias 是让真实版本“冒充”合法版本号参与依赖解析，必须用 as 语法在 require 或 repositories.package 中显式声明，如 "monolog/monolog": "dev-main as 2.0.0"，且仅影响版本解析，不改变包名、路径或自动加载。
Composer 的 version alias（版本别名）不是给包起新名字，而是让某个真实版本“冒充”另一个合法版本号参与依赖解析——它只在 require 行或 repositories.package 定义中生效，且必须用 as 语法显式声明。
require 中写 dev-main as 2.0.0 才有效
你在项目 composer.json 的 require 字段里直接写 "monolog/monolog": "dev-main as 2.0.0"，Composer 才会把 dev-main 分支当作 2.0.0 来解析依赖、校验约束、写入 composer.lock。
-
as左侧必须是真实可访问的源：比如dev-main、dev-fix-log、v5.4.42（注意带v前缀），不能是master或latest -
as右侧必须是合法版本字符串：如2.0.0、^2.0、2.0.x-dev，但不能是stable或dev-master - 写成
"monolog/monolog": "2.0.0 as 3.0.0"会报错：Invalid version string——as左边不能是稳定版标签 - 执行后必须运行
composer update monolog/monolog，仅composer install不会重新解析别名
extra.branch-alias 是包作者的事，不是你项目里的配置项
如果你在自己项目的 composer.json 里加 "extra": { "branch-alias": { "dev-main": "1.0.x-dev" } }，这完全无效。这个字段只对被 require 的**目标包自身**的 composer.json 有意义，且仅在 VCS 类型仓库（如 GitHub）中生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 它让别人能用
"your-vendor/your-pkg": "^1.0"拉到你的dev-main分支，前提是该包已 push 到远程并被 Packagist 索引 - 值必须以
-dev结尾，如1.0.x-dev；写成1.0.x或1.0-dev都不生效 - 分支名必须带
dev-前缀，哪怕 Git 里叫main，这里也得写"dev-main" - 运行
composer show your-vendor/your-pkg，如果输出里没出现1.0.x-dev，说明 alias 没被读取（常见于未 push 或 Packagist 缓存未更新）
想共存两个同名包？必须用 repositories + type: package
当你要同时使用官方 monolog/monolog 和某 fork 版本，又不能删掉旧包时，唯一可靠方式是：在项目 composer.json 的 repositories 里定义一个 type: package 条目，把 fork 映射为**同一个 name**，但指定不同 version 和 dist.url。
-
name必须和原包完全一致（如"monolog/monolog"），否则无法覆盖 -
version字段里可以写"dev-fix as 2.9.2"，这是 package 类型下唯一支持as的地方 -
dist.url必须指向 zip/tar 归档（不是 Git 地址），且归档内必须含正确composer.json和autoload配置 - 漏掉
autoload声明，类就加载不到；写错命名空间前缀，class not found立刻出现 - 别用
type: vcs—— 它不支持同名包覆盖，只会触发Package ... is already present错误
真正容易被忽略的是：别名只改版本解析逻辑，不改文件路径、不改自动加载规则、也不绕过 conflict 或 PHP 版本限制。你看到 composer show 列出别名版本，不代表类一定能加载——autoload 是否匹配，永远比 alias 更关键。
