Laravel扩展包安装后需按需注册ServiceProvider、发布配置/迁移等资源；Auto-Discovery适用于Laravel 5.5+且composer.json含laravel.providers字段的包；否则须手动注册并运行php artisan vendor:publish和php artisan migrate，同时清缓存确保生效。
直接用 composer require 安装 Laravel 扩展包基本没问题，但多数包需要手动注册 ServiceProvider、发布配置或迁移文件——这步漏掉，包大概率不生效。
如何判断一个包是否需要手动注册 ServiceProvider
看包的文档有没有写 “Add the service provider to your config/app.php” 或类似说明；更可靠的方法是查包的 composer.json 里是否有 "extra": { "laravel": { "providers": [...] } } 字段。有这个字段，Laravel 5.5+ 会自动发现（Auto-Discovery），否则必须手动加。
- 手动注册：在
config/app.php的'providers'数组末尾追加，如Barryvdh\Debugbar\ServiceProvider::class - Laravel 5.5+ 且包支持 Auto-Discovery：跳过注册，但需确认
composer.json中未禁用"minimum-stability": "dev"等干扰项 - 运行
php artisan package:discover可强制刷新自动发现缓存（有时改了composer.json没生效就靠它）
什么时候必须运行 php artisan vendor:publish
只要包带了配置文件（config/xxx.php）、迁移（database/migrations/）、视图或语言包，默认不会自动复制到项目目录——这些资源必须显式发布才能被项目读取。
- 发布全部：运行
php artisan vendor:publish，会列出所有可发布的资源组，按提示选编号 - 精准发布：先用
php artisan vendor:publish --list查标签（tag），再指定，如php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider" --tag="config" - 常见 tag 包括：
config、migrations、views、public；不同包的 tag 名可能不同，得看包文档
composer require 后没反应？检查这几个点
不是所有包都立即“可用”，尤其旧版 Laravel 或包本身兼容性差时，容易卡在依赖解析或类加载阶段。
- 确认 PHP 版本和 Laravel 版本匹配：比如
spatie/laravel-backupv8 要求 Laravel 9+，装在 Laravel 8 上会报require-dev冲突 - 安装后清缓存：
php artisan config:clear和php artisan cache:clear，否则新配置或服务可能不加载 - 如果报
Class not found，检查autoload是否更新：运行composer dump-autoload（尤其手动加了psr-4映射后） - 某些包（如
laravel/sanctum）要求先执行php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"才能跑php artisan migrate
发布迁移后忘记运行 php artisan migrate
很多包（laravel/passport、spatie/laravel-permission）把数据库结构放在迁移文件里，只发布不迁移，表根本不存在。
- 迁移前建议先
php artisan migrate:status看哪些没跑 - 若迁移失败（如字段已存在），不要直接删库重来，先查
migrations表确认记录，再决定是--force还是手动补记录 - 生产环境慎用
php artisan migrate:fresh，它会删全库；开发环境可配合--seed快速重置
最常被忽略的是：发布配置后没改 config/xxx.php 里的值，或者改了但没清配置缓存，结果一直用默认参数跑——调试时花半天才发现是缓存惹的祸。
