BenSampo/laravel-enum 在 v4.x 后放弃对 PHP 8.1 原生枚举支持，因其 final 特性无法继承 Enum；升级后应保持原库用法，迁移需重写全部用例、migration 和测试。
composer require ben-sampo/laravel-enum 失败？先确认 PHP 和 Laravel 版本兼容性
BenSampo/laravel-enum 在 v4.x 之后已**放弃对 PHP composer require ben-sampo/laravel-enum 会报错或装上旧版（如 v3.1），但该旧版不兼容 Laravel 9+ 的自动发现和部分类型提示逻辑。
- PHP 7.4 → 只能用
ben-sampo/laravel-enum:^3.0，且需手动注册服务提供者（BenSampoEnumEnumServiceProvider::class） - PHP 8.0 → 同上，但注意
v3.2+开始要求 Laravel 8.12+；低于该版本需锁死^3.1 - PHP 8.1+ → 直接
composer require ben-sampo/laravel-enum，默认装v4.x，Laravel 9/10 自动发现，无需手动配置
执行前先跑 php -v 和 php artisan --version，别靠印象判断。
安装后 php artisan vendor:publish 没反应？检查是否启用了自动发现
从 v4.0 起，包不再提供可发布的配置文件（比如 config/enum.php），vendor:publish 列表里压根不会出现它 —— 这不是命令失效，是设计如此。你不需要发布任何东西，也不需要额外配置就能用。
- 若你用的是
v3.x，则必须运行php artisan vendor:publish --provider="BenSampoEnumEnumServiceProvider"才能启用 -
v4.x下所有功能开箱即用：自动生成 accessor、支持 Eloquent cast、能直接在 Blade 中调用MyEnum::values() - 误以为“没发布=没装好”是常见误区，建议用
composer show ben-sampo/laravel-enum看实际安装版本
定义枚举类时继承 Enum 报错 Class not found？自动加载没生效
典型错误：Class 'BenSampoEnumEnum' not found，尤其在 PHP 7.4 + v3.1 组合下高频出现。
立即学习“PHP免费学习笔记（深入）”；
- 确认
use BenSampoEnumEnum;写在类文件顶部，且命名空间正确（比如AppEnumsStatus） -
v3.x需确保composer.json中 autoload 的 psr-4 已包含你的 enums 目录，例如："App\Enums\": "app/Enums/"，然后运行composer dump-autoload - Laravel 9+ 默认已注册
app/Enums，但如果你把枚举放在app/Support/Enums这类非标准路径，就必须手动加 autoload 规则
别跳过 dump-autoload，Composer 不会自动感知新目录。
PHP 8.1 原生 enum 和 ben-sampo/laravel-enum 能混用吗？不能直接替代
原生枚举是语言级特性，ben-sampo/laravel-enum 是框架增强方案 —— 二者定位不同，强行混用会导致序列化失败、Eloquent cast 异常、Blade 中 MyEnum::cases() 无法调用等。
- 原生
enum不支持 Laravel 的casts数组语法（'status' => StatusEnum::class会报错） -
ben-sampo枚举类必须继承Enum，而 PHP 8.1 原生枚举是 final 的，无法继承 - 已有项目用着
ben-sampo，升级到 PHP 8.1 后不要改用原生 enum，否则数据库字段映射、API 返回值、验证规则全得重写
真正要迁移，得重写所有用例、修改 migration、补全测试，不是改个关键字的事。
