别名仅在repositories的package类型中生效，需在package的version字段写“dev-main as 2.0.0”，require中写“monolog/monolog”: “^2.0”，且name必须完全一致、source.reference须有效，as右侧须为合法语义化版本。
别名只在 repositories 的 package 类型里生效
你在 require 字段直接写 "monolog/monolog": "dev-main as 2.0.0"，Composer 会报错：Invalid version string。别名机制不是给 root 包“起小名”的语法糖，它只在自定义仓库中声明 type: "package" 时才被识别——必须手动构造一个包描述，并把 as 写进它的 version 字段里。
常见错误是只改 require 行，漏掉 repositories 配置。正确结构是：
{
"repositories": [
{
"type": "package",
"package": {
"name": "monolog/monolog",
"version": "dev-main as 2.0.0",
"source": {
"url": "https://github.com/Seldaek/monolog",
"type": "git",
"reference": "main"
}
}
}
],
"require": {
"monolog/monolog": "^2.0"
}
}
-
name必须和require中完全一致（大小写敏感） -
version字段必须存在，且含as，不能只写"dev-main" -
source.reference要指向真实可拉取的 commit 或分支，否则composer update会失败
别名版本号必须是合法约束格式
"dev-main as 2.0" 不行，"dev-main as 2.0.0" 才行；"dev-feature as 1.5.x-dev" 可以，但 "dev-feature as latest" 会被忽略。Composer 对别名右侧的版本字符串执行完整解析，它必须能被 ^2.0、~1.5.0 或 1.5.* 这类标准约束匹配到。
验证方法：运行 composer update --dry-run，看输出里是否出现你写的别名版本（如 monolog/monolog 2.0.0），而不是原始分支名。
- 别名不改变 stability：如果原分支是
dev-main，默认按minimum-stability: stable会被跳过，需加--stability=dev或在config里设"minimum-stability": "dev" - 别名不能绕过
conflict声明：如果目标包的composer.json里写了"conflict": {"php": ">=8.2"}，而你系统是 PHP 8.3，照样失败 -
as后面不能是dev-开头的伪版本（如dev-2.0），必须是语义化版本或x.y.z-dev格式
别名不解决类名冲突和 API 不兼容
装上两个都声明 "psr-4": {"Monolog\": "src/"} 的包，哪怕用了不同别名，vendor/autoload.php 仍会把它们的类路径都注册进去——一旦有同名类（比如都定义了 Monolog\Logger），运行时必然报 Cannot declare class。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
别名只是让依赖解析器“点头”，不代表代码真兼容。例如把 symfony/console 5.4.0 别名为 3.4.49，若老代码调用了已被移除的 Command::setAliases()，启动就崩。
- 先用
composer why-not symfony/console:6.0确认谁在拦路，再查那个包的源码是否真用了已废弃 API - 检查冲突包的
autoload配置，尤其注意""（空命名空间）映射，它容易把其他包的类也扫进来 - 别名适合临时调试或私有包对接，生产环境应优先推动上游发正式 tag 或用
replace移除冲突源
branch-alias 已彻底失效，别再用 extra.branch-alias
Composer 2.0+ 已移除对 extra.branch-alias 的支持。你在包自己的 composer.json 里写：
"extra": {
"branch-alias": {
"dev-main": "2.0.x-dev"
}
}
这个配置现在完全被忽略。所有别名逻辑必须收束到你项目的 repositories + package + version: "... as ..." 这一闭环里。
如果你控制不了上游包（比如想让官方 monolog/monolog 的 dev-main 被当作 2.0.0 用），唯一办法就是自己在 repositories 里伪造一个同名 package 条目，并确保 name 和 version 精确匹配 require 约束。
最容易被忽略的一点：别名只影响当前项目的 root require 解析，不会改变子依赖内部的版本判断逻辑——也就是说，A 包依赖 B 包 ^1.0，你给 B 包加了别名，但 A 包自己锁死了 "require": {"B": "1.2.3"}，那别名依然无效。
