装不上扩展先查 autoload 配置和 vendor 目录是否被忽略或误删，再运行 composer dump-autoload、检查 .gitignore、验证包是否真安装，扩展逻辑优先用 service provider 或事件监听而非硬改 vendor。
composer require 装不上扩展？先看 autoload 和 vendor 目录是否被忽略
装完 composer require foo/bar 却发现类找不到，大概率不是命令错了，而是项目 autoload 配置没生效，或者 vendor/ 被 IDE/部署脚本误删或忽略。
- 检查
composer.json里是否有"autoload"段，且类型（"psr-4"或"classmap"）和路径匹配扩展包的结构 - 运行
composer dump-autoload强制重生成自动加载映射，别只信install或update的默认行为 - 确认
vendor/不在.gitignore里——有些团队误加，导致 CI 环境拉不到依赖 - 用
composer show foo/bar验证包是否真被安装进vendor/，而不是卡在缓存或镜像源失败
扩展要改核心逻辑？优先用 service provider 或事件监听，别直接 patch 类
想让 Laravel 扩展支持新数据库驱动，或给 Symfony 命令加钩子，硬改框架源码（比如直接修改 vendor/ 下的文件）是死路——下次 composer update 全清空。
- Laravel 项目：写一个
ServiceProvider，在register()或boot()里绑定新实现，比如替换Illuminate\Contracts\Cache\Repository - Symfony 项目：用
Kernel::configureContainer()注入自定义服务，或监听kernel.request这类标准事件 - 通用做法：查目标扩展的文档，找
extending、customization或hooks章节，90% 的主流包都预留了接口 - 如果扩展本身没提供扩展点，宁可 fork 后发 PR，也别本地改 vendor —— 可以用
repositories在composer.json里临时指向你的分支
require-dev 里的扩展怎么影响线上环境？autoload-dev 是关键开关
composer require --dev phpunit/phpunit 装的包，默认不会被生产环境加载，但如果你在 autoload-dev 里写了路径，又没加条件判断，上线后可能报错 Class not found。
-
autoload-dev中的 PSR-4 映射，只在composer install --no-dev以外才生效；但一旦你代码里写了new Tests\FooTest()，生产环境照样崩 - 避免在主逻辑里引用
require-dev包的类，尤其不要在config/或app/Providers/里 new 它们 - 测试工具类（如
Orchestra\Testbench）必须严格限定在tests/目录下使用，别让它“漏”进src/ - 用
composer install --no-dev --optimize-autoloader模拟线上环境跑一遍，比靠经验靠谱
换 PHP 版本后 composer install 失败？看扩展的 platform-config 和 ext-xxx 限制
PHP 8.2 升级后 composer install 报错 Your requirements could not be resolved，往往不是扩展不兼容，而是 composer.json 里锁死了 ext-mbstring 或 php 版本范围。
- 检查
"platform"配置项：它会覆盖真实环境，比如"php": "8.1"会让 Composer 当前环境“假装”是 8.1，哪怕你实际跑的是 8.2 - 运行
composer show --platform查看当前识别到的扩展列表，确认ext-json、ext-pdo等是否真已启用 - 某些旧扩展（如
monolog/monolog ^1.0）要求php: ^7.2，而你用了 PHP 8.2，就得升到^2.0或加--ignore-platform-reqs（仅调试用） - 别盲目删
platform—— 它常是为兼容 CI 环境设的，删了可能导致测试通过但线上出问题
最麻烦的其实是扩展之间的隐式冲突：A 包依赖 guzzlehttp/guzzle ^7.0，B 包锁死 ^6.5，Composer 不报错但运行时报 Method not found。这时候得看 composer why guzzlehttp/guzzle，一层层揪依赖树，不能只盯着自己 require 的那行。
