“package not installable”是依赖约束冲突所致，非包不存在；应先运行composer why-not vendor/package:version查阻塞链，再核对插件composer.json中laravel/framework和php版本约束，必要时用--with-dependencies显式重算依赖或手动注册服务提供者。
composer require 时提示“package not installable”怎么办
这不是包不存在，而是 Composer 在当前依赖图中找不到满足所有约束的安装路径。常见于 Laravel 插件声明了 "laravel/framework": "^9.0"，而你项目里是 "laravel/framework": "10.48.0"，两者 require 的 symfony/*、psr/* 或 guzzlehttp/guzzle 版本范围无交集。
优先执行：composer why-not vendor/package:version（例如 composer why-not laravel/sanctum:^4.0），输出倒序链路，最后一行是你写的 require，往上每行末尾的 (required by ...) 就是封杀源头。若输出为空，大概率是目标版本未发布，或冲突来自 require-dev（比如 phpunit/phpunit 拖住了 sebastian/exporter）。
验证是否真兼容：去该插件 GitHub 的 composer.json 文件里查 "require" 字段，重点看 laravel/framework 和 php 两行——别信 README 里模糊写的“Laravel 9+”，要看实际约束。
如何让新插件适配现有 Laravel 主版本
不能靠 composer update 碰运气，必须显式控制升级范围：
-
composer require vendor/package:^x.y --with-dependencies：强制重算该插件及其直系子依赖，避免只升插件却卡住symfony/console等底层包 - 若插件不支持当前 Laravel，但你又必须用，可临时降级 Laravel（不推荐）：先在
composer.json中改写"laravel/framework": "9.52.16"，再跑composer update laravel/framework --with-dependencies - 更安全的做法是找替代包：用
composer depends laravel/framework查谁依赖 Laravel，再结合composer prohibits laravel/framework:10.0看哪些包明确排斥 L10，从中识别可替换的旧插件
为什么装完插件后 artisan 命令不识别、类找不到
不是 Composer 没装成功，而是 Laravel 的自动发现机制没生效或被绕过：
- 检查该插件是否支持 Laravel Auto-Discovery：打开其
composer.json，确认有"extra": {"laravel": {"dont-discover": []}}或声明了"autoload": {"psr-4": {...}}且包含"providers"数组 - 手动注册服务提供者：在
config/app.php的'providers' => []里加一行，如Spatie\Permission\PermissionServiceProvider::class - 手动发布配置/迁移：运行
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"，否则config/permission.php不会生成 - 清 autoload 缓存：
composer dump-autoload和php artisan config:clear必须都执行，缺一不可
composer.lock 提交前最容易忽略的细节
团队协作中，composer.lock 不只是记录版本，它还固化了平台约束和解析路径：
- 如果本地 PHP 是 8.1，但生产是 8.2，别只改
composer.json里的"config": {"platform": {"php": "8.2.0"}}，必须跟上composer update --lock，否则 lock 文件仍按 8.1 解析 - CI 脚本中务必前置
php -v打日志，确认实际调用的 PHP 版本，避免update-alternatives切错全局版本导致依赖误装 - 不要把
"prefer-stable": true提交到主干，它可能压制掉插件必需的dev-main分支（某些包的稳定版尚未适配新版 Laravel）
