Composer install 后扩展包未自动注册，因 Laravel 自动发现仅在 install/update 时触发，需满足：包 composer.json 含有效 extra.laravel 配置、项目 Laravel ≥5.5；常见原因包括误设 dont-discover、使用 --no-scripts 或本地 path repo 未重扫描。
为什么 composer install 后扩展包没自动注册？
因为 Laravel 的自动发现（Package Discovery）默认只在 composer install 或 composer update 时触发，且依赖两个前提：扩展包的 composer.json 中必须声明 "extra": {"laravel": {"dont-discover": false}}（或不设该字段），同时你的项目 Laravel 版本 ≥ 5.5 —— 低于这个版本压根不支持，强行配也没用。
常见错误现象：php artisan tinker 里调用扩展包提供的 Facade 报错 Class not found，或 php artisan list 看不到新增命令，其实不是你漏写了 providers，而是发现机制根本没跑。
- 检查是否误加了
"dont-discover": true到自己项目的composer.json的extra区域 - 运行
composer dump-autoload不会触发发现，必须是install/update - 如果用了 Composer 的
--no-scripts参数，发现脚本会被跳过
discovery 脚本在哪执行？怎么确认它生效了？
Laravel 在 vendor/laravel/framework/src/Illuminate/Foundation/PackageManifest.php 里读取 vendor/composer/installed.json，再扫描每个包的 composer.json 中的 extra.laravel.providers 和 extra.laravel.aliases 字段。它不解析 PHP 代码，只认 JSON 配置。
实操建议：
- 手动触发一次发现：删掉
bootstrap/cache/packages.php，再跑composer update --lock（哪怕没更新包，也会重生成 manifest） - 看是否生效：打开
bootstrap/cache/packages.php，搜索你装的包名，如果里面有'providers' => [...]就说明被发现了 - 如果包没写
extra.laravel.providers，即使支持 Laravel，也不会被自动注册 —— 这是包作者的责任，不是你的配置问题
想禁用某个包的自动发现，但又不想改它的源码？
可以在你自己项目的 composer.json 里用 extra.laravel.dont-discover 精确排除，值是一个字符串数组，支持通配符 *。
例如：
"extra": {
"laravel": {
"dont-discover": [
"laravel/tinker",
"nunomaduro/collision"
]
}
}
注意点：
- 这个配置只对你自己的项目生效，不影响其他环境
- 写错包名（比如大小写不对、多空格）会导致排除失败，建议从
vendor/composer/installed.json复制准确名称 - 排除后，若需使用该包，仍要手动在
config/app.php里补上providers和aliases
自定义包怎么正确声明支持自动发现？
在你写的扩展包的 composer.json 里，必须明确写出 extra.laravel 结构，不能只靠文档说“兼容 Laravel”。
最小可用配置示例：
"extra": {
"laravel": {
"providers": [
"Vendor\Package\ServiceProvider"
],
"aliases": {
"Helper": "Vendor\Package\Facades\Helper"
}
}
}
关键细节：
-
providers数组里的类必须能被自动加载器找到（即已声明在包的autoload里） -
aliases是可选的；如果写了，对应 Facade 类必须存在且继承IlluminateSupportFacadesFacade - 不要在
extra.laravel里写条件逻辑（比如根据 Laravel 版本切换 provider），Laravel 不解析 PHP 表达式
最常被忽略的一点：本地开发时用 composer path repo 或 repositories.type: path 引入包，composer update 可能不会重新扫描该包的 composer.json —— 此时删掉 bootstrap/cache/packages.php 再试，比反复 dump-autoload 有效得多。
