Class not found 错误主因是自动加载未刷新，应优先执行 composer dump-autoload；若包未被发现，再运行 php artisan package:discover 并检查 composer.json 中 autoload 和 extra.lara vel 配置是否合规。
包明明装上了，一用就报 Class not found 或者命令不存在，这事儿是不是挺让人头疼的？其实，问题往往不在于包本身，而是 Lara vel 框架“没认出来”。背后的原因，多半是自动加载没刷新、服务提供者没注册，或者自动发现功能被意外关闭了。
composer require 后类找不到？先跑 dump-autoload
很多人以为，执行完 composer require vendor/package 就万事大吉了。实际上，这条命令只是把包下载到 vendor/ 目录并更新了 composer.json，并不会自动重新生成类的映射关系。Lara vel 在加载新类时，会去查询 vendor/autoload.php 里的那张“地图”，如果地图没更新，自然就找不到路了。
- 所以，第一步永远是立刻运行
composer dump-autoload，强制刷新这张类映射表。 - 接着，检查一下这个包的
composer.json文件，看看它是否包含了有效的autoload配置，比如："psr-4": {"Spatie\Permission\": "src/"}。 - 尤其要注意，如果包使用的是
classmap或者自定义的加载路径，那么执行dump-autoload这一步更是绝对不能跳过。
php artisan package:discover 没输出你的包名？看自动发现开关
从 Lara vel 5.5 开始，框架默认启用了“包自动发现”功能。但这有个前提：包的 composer.json 里不能设置 "dont-discover": ["*"]，并且必须声明了 extra.lara vel 这个配置段。
- 你可以运行
php artisan package:discover来验证，观察终端输出里是否出现了你的包名（例如SpatiePermissionPermissionServiceProvider）。 - 如果没出现？那就得去检查该包源码里的
composer.json了：确认它包含"extra": {"lara vel": {"dont-discover": false}}（或者干脆没有这一段配置）。 - 万一包被
dont-discover屏蔽了，那就只能手动将它的服务提供者（providers）添加到config/app.php文件里。
composer install 和 composer update 到底该用哪个？
这里有个常见的误区：在生产环境的部署脚本里写 composer update 其实是个高风险操作。因为它会忽略 composer.lock 文件，重新解析所有依赖的版本，一不小心就可能升级到不兼容的版本，导致线上服务崩溃。
- 记住这个原则：新项目克隆、CI/CD 流水线、线上部署，必须使用
composer install --no-dev。 - 如果只是想升级某个特定的包（比如修复一个安全漏洞），正确的命令是
composer update vendor/package --with-dependencies。 - 另外，
composer require是添加新包的唯一推荐方式；手动修改composer.json后再去跑update，很容易触发全量依赖升级，带来不必要的麻烦。
私有包装不上？权限、autoload、Git 标签三者缺一不可
配置了私有仓库（repositories），却还是提示 Could not find package？别急，问题大概率出在以下三个环节：
- 首先，私有包自己的
composer.json必须包含完整的"name": "acme/internal-utils"和autoload配置（例如"psr-4": {"Acme\InternalUtils\": "src/"}）。 - 其次，Git 仓库必须打上带
v前缀的语义化版本标签（比如v1.2.0），否则 Composer 不会将其识别为可安装的版本。 - 最后，如果使用的是 Git SSH 地址，务必确保部署服务器已经配置好对应的 SSH 密钥，并且能够成功执行
git clone。
说到底，最容易被忽略的一点是：包被放进 vendor/ 目录，并不等于它就能被 Lara vel 正常使用。框架的“识别链”——从自动加载（autoload）到包发现（discover），再到服务提供者注册和配置加载——其中任何一环断了，都会导致静默失败。下次再遇到类似问题，先别急着删除整个 vendor 目录重来，不妨盯紧 composer dump-autoload 和 php artisan package:discover 这两条命令的输出信息，往往就能找到突破口。
