直接运行 composer require 即可安装 Laravel 扩展包，但需确保其版本与当前 Laravel、PHP 版本兼容；不兼容时应指定旧版，部分包还需手动注册服务提供者和门面，且禁止随意执行 composer update。
直接运行 composer require 就行，但得看包是否支持 Laravel 版本
绝大多数 Laravel 扩展包都遵循 PSR-4 自动加载规范，执行 composer require vendor/package-name 后 Composer 会自动写入 autoload 并下载源码。关键不是“能不能装”，而是“装完能不能用”——重点检查包的 composer.json 里 "require": {"laravel/framework": "^10.0"} 这类约束是否和你当前项目匹配。
常见错误现象：composer require spatie/laravel-permission 在 Laravel 9 项目中报错 Your requirements could not be resolved，就是因为该包最新版只支持 Laravel 10+。此时应指定兼容版本：composer require spatie/laravel-permission:^5.10（查 GitHub Release 或 packagist.org 确认对应关系）。
- 执行前先确认
php artisan --version和composer show laravel/framework输出的版本号 - 不推荐用
--ignore-platform-reqs强行安装，容易引发运行时异常 - 有些包要求 PHP >= 8.1，而你的环境是 8.0，也会被 Composer 拦住
部分包需要手动注册 Service Provider 和 Facade
Laravel 5.5+ 支持包自动发现（extra.laravel.dont-discover 除外），但仍有大量老包或轻量工具库（如 ramsey/uuid、monolog/monolog）不带 laravel 配置段，需手动接入。
以 intervention/image 为例（Laravel 10 已默认移除）：
composer require intervention/image
之后必须做两件事：
- 在
config/app.php的'providers'数组中添加：Intervention\Image\ImageServiceProvider::class - 在
'aliases'中添加：'Image' => Intervention\Image\Facades\Image::class
漏掉任一环节都会报 Class 'Image' not found 或 Target class [image] does not exist。
composer update 不要乱跑，尤其别在生产环境执行
很多人误以为装完新包后要立刻 composer update，结果把所有依赖全升到最新版，可能引入不兼容变更。正确做法是只更新目标包：composer require vendor/package-name:version，或者干脆不加版本让 Composer 自动选兼容版。
更危险的是在部署脚本里写死 composer update —— 它会忽略 composer.lock，导致线上行为和本地不一致。
-
composer install（有 lock 文件时）才保证依赖一致性 - CI/CD 流程中应禁用
update，只允许install --no-dev - 若真要升级某包，用
composer update vendor/package-name显式指定
发布配置文件和迁移前先看文档，别无脑执行 php artisan vendor:publish
像 laravel/sanctum、spatie/laravel-backup 这类功能型包，通常带配置和迁移。但 php artisan vendor:publish 默认列出全部可发布资源，选错选项可能导致覆盖已有配置。
安全做法是按包名精确发布：
php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"
或按标签（tag）筛选：
php artisan vendor:publish --tag=laravel-assets
发布后务必检查生成的文件路径是否符合预期，比如 config/sanctum.php 是否出现在 config/ 下；迁移文件是否进了 database/migrations/ 而非根目录。
真正容易被忽略的是：有些包的迁移必须在 php artisan migrate 前手动修改字段类型或索引，否则建表失败。比如 MySQL 低版本不支持 json 字段，而 sanctum 的迁移默认用了它。
