先确认三件事：composer版本≥2.2、当前目录为项目根目录、包名写全（含vendor）；再检查package discovery是否关闭、autoload是否刷新、laravel版本与包兼容性。
composer require 装不上包？先确认这三件事
装不成功，90% 不是 Laravel 的问题，而是 composer 本身环境或命令用法没对。别急着换镜像或删 vendor，先看基础条件。
-
composer版本得 ≥ 2.2（Laravel 10+ 强制要求），运行composer --version确认；旧版会卡在依赖解析甚至报Root composer.json requires ... but it is not installable - 当前目录必须是 Laravel 项目根目录（含
composer.json和artisan），不是app/或vendor/ - 包名写全：比如装 Laravel Debugbar，得用
composer require barryvdh/laravel-debugbar，不能只写debugbar或漏掉 vendor 名
Laravel 服务提供者没自动注册？检查 package discovery 是否关闭
很多包（如 spatie/laravel-permission）依赖 Composer 的 autoload + extra.laravel.dont-discover 机制自动注册服务提供者。如果手动关了 discovery，包装上了但功能不生效，就容易以为“装失败”。
- 查
composer.json里有没有"dont-discover": ["*"]或指定包名——有就删掉，或者把要装的包从列表里移除 - 装完后运行
php artisan package:discover手动触发一次（Laravel 5.5+ 默认自动，但某些 CI 或部署流程会跳过） - 若包明确要求手动注册，得去
config/app.php的providers数组加一行，比如Barryvdh\Debugbar\ServiceProvider::class
装完报 Class not found 或 Target class does not exist？autoload 没刷新
Composer 装包后只改了 composer.json 和 composer.lock，类文件不会自动进 PHP 的自动加载映射里——这是最常被忽略的一步。
Laravel 13.2.0
下载
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
- 必须运行
composer dump-autoload（简称composer du），否则php artisan tinker里 new 一个类会直接报错 - 如果用了 PSR-4 自定义命名空间（比如自己写的包），确保
composer.json的autoload.ps4配置正确，且路径真实存在 - 开发中频繁增删包时，可加
-o参数优化：composer dump-autoload -o，生成静态映射，避免每次请求都扫描文件
升级 Laravel 后扩展包报错？看 major version 兼容性
不是所有包都支持 Laravel 10/11，尤其那些重度依赖 Facade 或 Contracts 的——比如 laravelcollective/html 在 Laravel 10 就得切到 ^6.0，用 ^5.0 会爆 Class Collective\Html\HtmlBuilder does not exist。
- 查包的 GitHub README 或 packagist 页面，重点看 “Laravel Version Compatibility” 表格，别信默认 latest tag
- 装的时候显式指定兼容版本：
composer require laravelcollective/html:^6.0，而不是composer require laravelcollective/html - 有些包已弃更（如
laracasts/presenter），得找替代方案，硬装高版本只会让composer update卡死在依赖冲突
真正麻烦的不是装不上，而是装上了但没生效——服务提供者没注册、autoload 没刷新、版本撞车，这三个点卡住，调试起来比重装还耗时间。
