laravel 5.5+ 包安装后多数可直接使用，因自动发现机制启用；若未自动注册需手动添加服务提供者和别名，检查版本兼容性及依赖冲突是关键。
直接装就行，不用额外配置，但必须注意包的 Laravel 版本兼容性和服务提供者是否自动发现。
composer require 装完就用？先看包有没有自动发现
新版 Laravel（5.5+）默认启用 Package Discovery，多数主流包（比如 laravel/sanctum、spatie/laravel-permission）装完 composer require 就能直接用，无需手动 php artisan vendor:publish 或改 config/app.php。
- 检查包文档里是否写明 “Auto-discovery supported” —— 没写就大概率要手动注册
- 装完运行
php artisan package:discover，看输出里有没有你的包名；没出现说明没被识别，得查composer.json里的extra.laravel.dont-discover是否误禁用了 - 老包（如
barryvdh/laravel-ide-helper）仍需手动加到providers数组，否则php artisan ide-helper:generate会报错Command "ide-helper:generate" is not defined
遇到 Class not found 或 Service Provider 找不到
典型现象是执行命令或访问路由时抛出 Class 'App\Providers\SomeServiceProvider' not found，或者 Target class [xxx] does not exist。
- 先确认包是否真装进来了：检查
vendor/目录下有没有对应文件夹，比如vendor/spatie/laravel-permission - 运行
composer dump-autoload—— 有时 autoload 没刷新，类加载器找不到新包的命名空间 - 如果包要求手动注册，在
config/app.php的providers数组末尾加一行：Spatie\Permission\PermissionServiceProvider::class - 别漏掉
aliases（如果包有 Facade）：比如'Permission' => Spatie\Permission\Facades\Permission::class
为什么 php artisan vendor:publish 没反应？
不是所有包都带可发布资源，vendor:publish 默认只列出“有 publishable assets”的包。没反应 ≠ 安装失败。
- 先查包的
composer.json里有没有extra: { "laravel": { "dont-discover": false } }和publishes配置 - 想强制看有哪些可发布项：运行
php artisan vendor:publish --list，如果列表为空，说明这个包压根没声明要发布任何东西 - 有些包（如
laravel/scout）只在执行php artisan scout:install后才生成配置，不能靠vendor:publish硬凑 - 别乱加
--force，覆盖本地改过的配置前务必先git diff
真正麻烦的不是安装动作本身，而是包和当前 Laravel 版本、PHP 版本、其他已装包之间的隐式冲突——比如一个包依赖 guzzlehttp/guzzle:^7.0，而你项目里已有 ^6.0，composer require 会直接失败，得先 composer update guzzlehttp/guzzle 或换兼容版本。这种事不报错到运行时根本看不出。
