Composer不支持“昵称式别名”，合法别名仅是version字段中"dev-branch as X.Y.Z"的版本映射，用于让开发分支冒充稳定版本以通过依赖检查，必须配合vcs或package类型repositories配置，且不解决命名空间或autoload冲突。
Composer 本身不支持给包起“昵称式别名”，比如 composer require vendor/pkg as my-alias 这种写法直接报错。所谓“别名”，实际是版本映射或包身份重定义，只在特定上下文生效，且极易配错导致类加载失败或依赖解析静默失败。
别名只存在于 version 字段的 as 语法里
你在 require 中写的版本字符串，如果含 as，才是 Composer 认可的别名用法。它不是起新名字，而是让某个开发版本“冒充”一个稳定版本号，用来骗过依赖检查。
-
"monolog/monolog": "dev-fix-logging as 2.9.2"合法：分支dev-fix-logging被当成2.9.2安装，其他依赖看到的是2.9.2，能通过"^2.9"约束 -
"monolog/monolog": "2.9.1 as 3.0.0"风险极高：若代码没实现 v3 接口，运行时直接Fatal error: Call to undefined method -
"monolog/monolog": "dev-main as latest"无效：latest不是合法版本约束，Composer 报Invalid version string - 别名必须配合
repositories中的vcs类型定义（指向你的 fork），否则dev-fix-logging根本找不到
想换包名？只能用 repositories.type: package
如果你真需要把 monolog/monolog 换成 my/logger 这种名字出现在 vendor/ 目录里，必须放弃 vcs，改用 package 类型手动声明，并完整复制 autoload 配置。
-
name字段写你想用的“别名”，如"my/logger"，它会成为最终安装目录名 -
version必须精确（不能带^或~），如"3.0.0"，否则 Composer 不知道该拉哪个 commit -
dist.url要指向 zip/tar 归档地址，不是 GitHub 仓库 URL；用 Git 地址会报错 -
autoload块必须手写，哪怕和原包一样——别名不会继承原包 autoload，漏了就Class not found
命名空间冲突？别碰 alias，先看 autoload 映射
两个包都声明 "App\": "src/"，或都注册 "Helper" 到根命名空间，不是 alias 能解决的。Composer 的 PSR-4 加载器只保留最后一个映射，前面的被覆盖，错误表现是类突然找不到，且无任何冲突提示。
- 用
composer show --tree和grep -r "namespace App\" vendor/找出哪些包在抢同一命名空间 - 优先改包自身：推动上游把
"App\": "src/"收紧为"VendorName\Package\": "src/" - 若无法修改，唯一可靠解法是弃用 PSR-4，统一改用
classmap，并确保所有同名空间下的类文件路径不重复（例如PackageA/src/Helper.phpvsPackageB/src/VendorB_Helper.php） -
exclude-from-classmap对 PSR-4 无效，别白费劲
alias 是个高危操作，它绕过语义化版本校验，不改代码、不补方法、不处理 PHP 版本差异。真正要防冲突，得从命名空间设计源头卡住——宽泛前缀、根命名空间类、未声明 replace/conflict 的 fork 包，才是埋雷主力。alias 只是临时止血，不是创可贴。
