Composer本身不解析extra.laravel.aliases，该字段仅由Laravel读取用于注册Facade别名，与包安装无关；真正的包安装别名需通过repositories+package类型手动配置。
Composer 本身不支持“自动别名发现”——Laravel 的自动发现机制只认 extra.laravel.providers 和 extra.laravel.aliases，而后者专指 Facade 别名（如 MyPackage → Vendor\Package\Facades\MyPackage），不是包安装层面的别名。
为什么在 composer.json 里写 "extra.laravel.aliases" 不会让包被“以别名方式安装”
这个字段只影响 Laravel 启动时注册的 Facade 全局类名，和 Composer 安装行为完全无关。它不会改变包名、不修改 vendor 目录结构、也不触发任何包重映射逻辑。
-
extra.laravel.aliases是 Laravel 框架读取并处理的字段，Composer 自己根本不解析它 - 该字段值是键值对：
"MyPackage": "Vendor\Package\Facades\MyPackage"，仅用于app('MyPackage')或MyPackage::do()这类调用 - 如果类文件不可自动加载（比如没在
autoload.psr-4中声明），哪怕配置了 aliases，运行时仍报Class not found - 它和
repositories+package类型定义的“安装别名”毫无关系，混用会导致预期外的行为
想让 Laravel 项目“以别名形式安装”一个包，唯一可行路径
必须绕过 Laravel 的自动发现机制，改用 Composer 原生的 repositories + package 方式手动接管，并确保 Laravel 能加载到该包的服务提供者。
- 在项目的
composer.json中添加repositories，type设为package -
package.name写你想要的“别名”（如myorg/logger），不是原包名 -
package.version必须精确（如"3.0.0"），不能带^或~ -
package.dist.url指向 zip 包，且压缩包内必须含合法composer.json，其中autoload.psr-4映射正确 - 在
require中写"myorg/logger": "^3.0"—— 此时 Composer 才会按别名拉取并安装 - Laravel 自动发现仍会生效，但前提是该 zip 包内的
composer.json也正确定义了extra.laravel.providers
常见失败原因：你以为配了 extra 就能 alias，其实两套机制互不感知
很多人把 extra.laravel.providers 和 “包别名”混淆，结果改完配置跑 php artisan package:discover 却看不到注册，或者类根本加载不了。
- Composer 不解析
extra.laravel.*，所以你在包里加了aliases字段，对安装路径、vendor 目录名、类加载路径都无影响 - 如果你的包实际叫
vendor/original，但希望下游项目require my-alias，那必须在下游项目的repositories里定义my-alias，并在require中引用它 —— Laravel 的extra字段在这里只是“锦上添花”，不是前提 - 运行
composer dump-autoload不会刷新repositories映射，必须跑composer update my-alias或删 lock+vendor 重装 -
bootstrap/cache/packages.php只记录被 Laravel 发现的providers，它不会因为包名是别名就跳过；但前提是那个别名包的composer.json真的包含extra.laravel.providers
真正容易被忽略的是：Laravel 的自动发现和 Composer 的包别名是两条平行线。前者只管“启动时注册什么类”，后者只管“安装时从哪拉什么内容”。想让它们协同工作，你得在别名包的源头就配好 extra.laravel.providers，而不是指望下游项目靠改一两个字段就能魔法生效。
