在 Laravel 中添加功能包本质是安装依赖并启用集成：1. 用 composer require 安装包并触发自动发现；2. 按文档检查是否需发布配置、运行迁移、注册服务提供者或添加 trait；3. 在代码中直接使用；4. 通过重载类映射、清缓存等调试。
在 Laravel 项目中添加新功能包，本质是通过 Composer 安装第三方 PHP 包，并按需配置服务提供者、门面、配置文件或迁移等。关键不是“加代码”，而是“加依赖 + 启用集成”。
1. 使用 composer require 安装包
在项目根目录（含 composer.json 的位置）运行命令：
composer require spatie/laravel-permission
这条命令会做三件事：下载包到 vendor/、写入 composer.json 的 "require" 区、执行包的自动发现（如果支持）。Laravel 5.5+ 默认启用 Package Auto-Discovery，多数主流包无需手动注册服务提供者。
2. 检查是否需要手动配置
不是所有包都开箱即用。安装后快速查看文档，重点关注：
- 是否需发布配置文件？例如：
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" - 是否需运行迁移？例如：
php artisan migrate - 是否需在 config/app.php 中手动添加
providers或aliases？（Laravel 9+ 已移除aliases，推荐用 FQCN 或use） - 是否需在模型中使用 trait？例如：
use HasRoles;加到User模型里
3. 在代码中使用新功能
以 spatie/laravel-permission 为例，安装并发布配置、运行迁移后，可直接在控制器或 Blade 中使用：
// 控制器中赋予权限
$user = User::find(1);
$user->givePermissionTo('edit articles');
// Blade 中检查权限
@can('delete articles')
<button>Delete</button>
@endcan
4. 验证与调试小技巧
如果功能不生效，别急着重装：
- 运行
composer dump-autoload确保类映射更新（尤其手动改过composer.json后） - 清空 Laravel 缓存：
php artisan config:clear && php artisan cache:clear - 用
php artisan package:discover强制重新扫描自动发现包（少数情况需要） - 查看
vendor/composer/autoload_psr4.php确认包命名空间是否已注册
基本上就这些。Composer 是依赖管理工具，不是魔法开关——装完包，该配的配，该跑的跑，该用的用。不复杂但容易忽略细节。
