composer装包失败90%以上源于本地环境或配置冲突，而非网络问题；需区分composer install（依赖lock文件，报错多在下载或autoload）与composer require（重算依赖树，报错多在版本冲突或平台约束），并依错误类型精准排查php环境、权限、证书、时间、autoload映射等根本原因。
Composer 装包失败，90% 以上不是网络问题，而是本地环境或配置冲突导致的；直接换镜像或重试往往掩盖真实原因，反而耽误排障时间。
看清楚 composer install 和 composer require 报错位置的区别
这两个命令触发的依赖解析逻辑不同：composer install 读取 composer.lock 精确还原，报错多在「下载阶段」或「自动加载生成失败」；composer require 则要重新计算依赖树，报错更常出现在「版本冲突」或「平台约束不满足」。
- 如果
composer install失败但composer.lock是刚生成的，优先检查vendor/权限、磁盘空间或autoload配置语法错误 - 如果
composer require foo/bar报Conclusion: don't install foo/bar v2.0.0，说明已有依赖锁死了某个包的旧版本，用composer prohibits foo/bar:^2.0查谁在拦着 -
composer update --dry-run可提前预演依赖变更，比直接update安全得多
遇到 Could not fetch https://repo.packagist.org/... 先别急着切镜像
这个错误表面是网络超时，但实际可能是 CA 证书过期、PHP cURL 不支持 TLS 1.2+、或系统时间严重偏差（比如虚拟机休眠后没同步时间）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
php -r "print_r(openssl_get_cert_locations());"看default_cert_file是否存在且可读 - 执行
curl -I https://repo.packagist.org/packages.json，如果返回curl: (35) SSL connect error，基本确定是 OpenSSL 或系统时间问题 - 用
date检查系统时间，误差超过 5 分钟会导致 TLS 握手失败（尤其在 macOS 或某些 Docker 容器里） - 临时验证是否镜像问题：加
-vvv参数跑composer require --no-cache，看日志里最终请求的是哪个 URL
Class not found 却明确已装包？重点查 autoload 和 psr-4 映射
装包成功但运行时报类找不到，大概率是 Composer 自动加载机制没生效，而不是包没装上。
- 确认
composer.json里的autoload/autoload-dev中的psr-4路径映射是否拼写正确，末尾是否多了斜杠（"App\": "app/"✅，"App\": "app//"❌） - 修改
composer.json后必须运行composer dump-autoload（或install/update），否则不会更新vendor/autoload.php - 若用 symlink 方式安装（如
composer config --global bin-dir），检查vendor/bin下的软链目标是否存在，尤其在 Windows WSL 环境下容易断链 - 在 CLI 环境下运行
php -d display_errors=1 -d error_reporting=-1 vendor/autoload.php可快速验证自动加载文件本身是否语法合法
升级 Composer 自身前，先看 composer --version 和 PHP 版本兼容性
Composer 2.5+ 要求 PHP ≥ 7.4，而 Composer 2.7+ 已彻底放弃对 PHP 7.x 的支持；盲目 composer self-update 可能导致后续所有命令直接退出。
- 运行
php -v和composer --version对照官方兼容表（如 Composer 文档） - 降级命令是
composer self-update --1（切回 v1）或composer self-update 2.5.8（指定旧版） - 某些共享主机或 CI 环境中，
composer实际调用的是系统预装的全局二进制，和php composer.phar行为不一致，建议统一用后者避免混淆
最常被跳过的一步：删掉 vendor/ 和 composer.lock 后只跑 composer install —— 这个操作看似暴力，实则是排除「局部缓存污染」最有效的手段。但要注意，它会忽略 composer.json 里 require-dev 的版本约束，所以开发环境务必补上 --with-all-dependencies。
