Laravel 扩展包安装失败主因是包名错误、版本不兼容或未刷新自动加载；需核对标准包名、Laravel 版本约束，手动注册服务提供者、发布配置，并执行 composer dump-autoload 和 artisan 缓存清理。
composer require 装不上 Laravel 插件？先看是不是包名写错了
绝大多数装不上的问题，根源在包名。Laravel 官方生态里没有“插件”这个概念，只有 composer package —— 也就是通过 composer require 安装的第三方包。很多用户搜“Laravel 插件”，实际想找的是像 laravel/sanctum、spatie/laravel-permission 这类扩展包。
- 别用中文名或模糊描述去搜，比如“权限插件”“日志增强”，直接查文档确认标准包名
- 注意命名空间分隔符：GitHub 上仓库名是
spatie/laravel-permission，不是spatie/laravel_permission（下划线错） - 有些包已弃用，比如旧版
barryvdh/laravel-debugbar在 Laravel 10+ 需要加@^3.13版本约束，否则因依赖冲突失败
装完 composer require 没反应？检查是否跳过了自动发现
Laravel 5.5+ 默认启用 Package Auto-Discovery，但不是所有包都支持，也不是所有场景都生效。如果安装后类找不到、命令不出现、配置不加载，大概率是服务提供者没注册。
- 手动注册：打开
config/app.php，在'providers' => []里加一行，例如Spatie\Permission\PermissionServiceProvider::class - 手动发布配置：运行
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"，否则config/permission.php不会生成 - 某些包（如
laravel/scout）必须手动执行php artisan scout:install才能初始化数据库结构
composer update 导致 Laravel 报错？版本兼容性比想象中更敏感
很多人习惯装完一个包就跑 composer update，结果整个项目崩掉。这不是 Composer 的锅，而是 Laravel 主版本和扩展包之间存在严格的约束关系。
- 查看包的
composer.json中"require": {"laravel/framework": "^9.0"}这类声明，确认它是否支持你当前的 Laravel 版本 - 不要盲目加
--with-all-dependencies，它可能强行升级symfony/*组件，而 Laravel 某些版本锁死了 Symfony 小版本（如 Laravel 9.51 要求symfony/http-foundation: ^6.0.0） - 临时解决冲突：用
composer require vendor/package:version --with-dependencies显式指定兼容版本，比如composer require laravel/sanctum:^3.2（对应 Laravel 9）
为什么 php artisan 命令不识别新包的命令？autoload 没刷新
即使包已安装、服务提供者也注册了，artisan 命令仍不出现，常见原因是 Composer 的自动加载映射没更新，或者 Laravel 的命令缓存没清。
- 先运行
composer dump-autoload，强制重生成vendor/autoload.php - 再清 Laravel 缓存：
php artisan config:clear和php artisan cache:clear，否则命令类可能被旧缓存屏蔽 - 某些包（如
laravel/horizon）需要额外执行php artisan horizon:install才把命令注入到 artisan - 如果用了 Docker 或部署环境，确保
vendor/目录在容器内完整挂载，且artisan是在容器内执行的，不是本地 shell
最常被忽略的一点：很多包的文档只写“安装即可”，但没说清楚它依赖哪个 Laravel 核心机制（比如事件系统、队列驱动、缓存配置）。装之前务必打开它的 README.md，盯住 “Requirements” 和 “Installation” 两节，而不是直接抄命令。
