vendor未更新的根本原因是未在项目根目录执行命令，需确认存在composer.json和artisan文件；版本应避免dev-main，优先用^或~约束；自动加载失败时先运行composer dump-autoload再清缓存。
composer require 之后为什么 vendor 没更新？
常见现象是执行 composer require foo/bar 后，vendor/ 目录里没出现对应包，甚至 composer.json 也没写入依赖项。根本原因通常是当前目录不是 Laravel 项目根目录——也就是没有 composer.json 和 artisan 的那个文件夹。
实操建议：
- 先确认你在项目根目录运行命令：用
ls -la | grep composer.json（Mac/Linux）或dir composer.json（Windows）检查 - 别在
app/或resources/下执行composer require - 如果误操作了，删掉生成的临时
composer.json，回到正确路径重试 - 某些包要求 PHP 或 Laravel 版本匹配，
composer require会静默失败（不报错但不写入），加-v参数看详细输出：composer require foo/bar -v
Laravel 10+ 安装包后要手动注册 ServiceProvider 吗？
大多数现代 Laravel 扩展包（Laravel 5.5+ 起）支持自动发现（Auto-Discovery），只要包的 composer.json 里声明了 "extra": {"laravel": {"dont-discover": []}}，安装后就无需手动改 config/app.php。
但仍有三类情况必须手动处理：
- 包明确文档写了“Not auto-discovered”，比如老版本的
barryvdh/laravel-debugbar（Laravel 10 需手动加Barryvdh\Debugbar\ServiceProvider::class） - 你禁用了自动发现（
"dont-discover": ["*"]），这时所有包都得手配 - 包需要发布配置文件或迁移：必须运行
php artisan vendor:publish --provider="Vendor\Package\ServiceProvider"，否则config/里没对应文件
dev-main、^3.2、v2.1.0 这些版本约束怎么选？
版本写法直接影响稳定性。新手常直接粘贴文档里的 composer require vendor/package:dev-main，结果上线后因主分支变动导致行为突变。
安全选择原则：
- 生产环境永远避开
dev-main、dev-develop—— 它们不是语义化版本，随时可能 break - 优先用波浪号
~3.2.0（允许3.2.x）、插入号^3.2（允许3.x.x，但4.0.0不行），这是 Composer 默认行为 - 如果包文档只写了
v2.1.0，安装时去掉v：用composer require vendor/package:2.1.0，否则 Composer 会报Could not parse version constraint - 不确定兼容性？查包的
composer.json里"require": {"php": "...", "laravel/framework": "..."}字段，和你本地php -v、composer show laravel/framework对齐
安装完跑 php artisan config:clear 报错 Class not found
典型错误信息是 Class 'Vendor\Package\FooServiceProvider' not found，尤其在执行 config:clear、cache:clear 或首次访问时触发。这不是缓存问题，而是自动加载没生效。
解决步骤很固定：
- 先运行
composer dump-autoload（或简写composer du），强制刷新 PSR-4 映射 - 再清缓存：
php artisan config:clear && php artisan cache:clear - 如果仍报错，检查
vendor/composer/autoload_psr4.php里是否有该包的命名空间映射；没有说明composer require实际没成功（比如网络中断、权限不足） - Windows 用户注意：有时防病毒软件会锁住
vendor/文件，临时关闭实时防护再试
最易被忽略的是：Composer 安装过程看似完成，但退出码非 0（比如因内存不足中止），而终端没显示明显错误。遇到任何异常，第一反应不是重装，而是看 composer require xxx -v 的末尾几行输出，重点找 Installing... 后有没有 Generating autoload files。
