composer require 后类找不到，主因是未自动刷新 autoload 映射；必须执行 composer dump-autoload（常需 -o 或 --dev）强制重建 PSR-4/classmap 映射，且新包自身 composer.json 中须正确定义 autoload 规则。
第三方插件（即 Composer 包）不是“插件”概念，而是标准的 PHP 包；管理它们的关键不是手动拷贝或改 autoload，而是让 composer require 正确解析依赖树、锁定版本、并适配运行环境。镜像只是加速手段，不能掩盖依赖链错配的根本问题。
为什么 composer require 后类找不到？autoload 没刷新
常见现象：执行 composer require spatie/laravel-permission 后，use SpatiePermissionModelsRole; 报 Class not found。
-
composer require只写入composer.json并安装包到vendor/，但不会自动重生成自动加载映射（尤其是 PSR-4 或 classmap） - Laravel 项目默认启用 classmap 加载，但新包若没在
composer.json的autoload或autoload-dev中声明路径，就不会被扫描 - 解决办法：运行
composer dump-autoload强制重建映射；如果包含自定义命名空间（如"psr-4": {"MyLib\": "lib/"}），必须确保该配置已存在于其自己的composer.json中
依赖链冲突时怎么查谁在拖后腿？composer why 和 composer depends
当你想升级 guzzlehttp/guzzle 却被卡住，或者 composer update 报错“can't resolve”，本质是某上游包锁死了旧版本。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer why guzzlehttp/guzzle：列出所有直接或间接依赖它的包（含版本约束），帮你定位“谁不让升” -
composer depends --tree guzzlehttp/guzzle：显示完整依赖树，看清是laravel/framework还是某个内部 SDK 在传导旧约束 - 注意：Laravel 自身对
illuminate/*组件版本极其敏感，升级第三方包前先看它是否声明支持当前 Laravel 版本（比如 Laravel 10 要求 PHP 8.1+，而某些老包只兼容 PHP 7.4）
Docker 构建中 vendor 不一致？platform 配置漏了
本地 composer install 成功，Docker 容器里却报 ParseError: readonly property 或 Class ZipArchive not found——这不是镜像源问题，是平台能力没对齐。
-
config.platform.php必须显式声明，例如："config": {"platform": {"php": "8.2.15", "ext-zip": "8.2.15"}}；否则 Composer 会按构建机环境推测能力，装入不兼容语法或扩展 - builder 镜像（如
php:8.2-cli）和 final 镜像（如php:8.2-fpm-alpine）必须 PHP 版本、SAPI 类型、关键扩展（zip、mbstring、pdo）完全一致 - Alpine 镜像需提前
RUN apk add --no-cache ca-certificates git unzip，否则git clone或 SSL 请求失败，导致部分包安装中断
国内镜像加速但依然慢？COPY 顺序和缓存失效才是根因
很多人以为换阿里云镜像就万事大吉，结果 Docker 构建仍超时。真正瓶颈是缓存未命中 + 错误的 COPY 顺序。
- 必须先
COPY composer.lock .，再COPY composer.json .，最后RUN composer install；否则 Composer 会退化为update，破坏可重现性且无法利用 layer 缓存 - 镜像源要在
RUN阶段设置：RUN composer config -g repo.packagist https://mirrors.aliyun.com/composer/，不能只靠全局配置或环境变量 -
composer.lock提交前，务必运行composer update --lock并验证composer show --platform输出与目标环境一致，否则镜像再快也装错东西
最常被忽略的点：依赖不是“装上就行”，而是“在正确的 PHP 环境里，用正确的平台声明，生成正确的 autoload 映射”。镜像只解决下载速度，解决不了 platform 错配、autoload 漏刷、COPY 顺序错误这三类硬伤。
