答案是网络阻断或镜像未同步导致元数据获取失败，非包名错误；需清缓存、验证镜像配置（含https末尾斜杠与type值）、检查同步延迟，并优先用curl和镜像网页确认连通性与数据存在。
Composer install 报错 Could not find package xxx 的常见原因
不是包真不存在，而是 Composer 默认从 packagist.org 拉取元数据时被阻断或超时，导致本地缓存里查不到包信息。国内直连 packagist.org 常出现连接失败、响应慢、返回空结果等情况，composer install 或 composer require 就会直接报“找不到包”。
这不是你写错包名，也不是包已下架，大概率是网络层没拿到索引。
- 执行
composer clear-cache后重试，排除本地缓存污染 - 运行
composer config -g repo.packagist查看当前全局镜像配置（可能为空或指向失效地址） - 用
curl -I https://packagist.org/packages/list.json手动测试能否访问原始源（注意：该接口已弃用，但可辅助判断网络通路）
切换国内镜像源的三种可靠方式
推荐使用腾讯云、阿里云或华为云镜像，它们同步频率高、稳定性好。不要用已停更或文档缺失的第三方镜像。
优先用全局配置，避免每个项目重复设置：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 全局启用腾讯云镜像：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 临时单次使用（不改配置）：
composer install --repository=https://mirrors.aliyun.com/composer/ - 项目级配置（写入当前
composer.json）：composer config repository.packagist composer https://mirrors.huaweicloud.com/composer/
注意：repo.packagist 是旧写法，新版本 Composer（2.2+）建议用 repository.packagist；如果配置后仍无效，检查是否拼错为 repos.packagist 或漏掉 composer 类型声明。
镜像不同步导致“包存在但装不上”的排查要点
有些包（尤其是刚发布或 dev 分支）在 packagist.org 上已更新，但镜像源尚未同步，就会出现“官网能搜到、Composer 却说找不到”。这不是配置错误，而是时间差问题。
- 访问镜像站网页（如
https://mirrors.cloud.tencent.com/composer/p/monolog/monolog.json）直接查包是否存在 - 对比原始源地址：
https://packagist.org/p/monolog/monolog.json，看两者packages字段是否一致 - 若镜像缺失，可临时切回官方源：
composer config -g repo.packagist false（注意：false 表示禁用镜像，非字符串 "false"） - 部分私有包或 GitHub 仓库直链（
vcs类型）不受镜像影响，需单独确认repositories配置是否正确
Composer 2.x 的镜像兼容性与协议变更
Composer 2.2 起默认使用 packages.json 的压缩格式（.json.gz），部分老旧镜像未开启 gzip 支持，会导致 404 或解析失败，表现为“找不到包”但 HTTP 状态码是 200。
- 检查镜像文档是否明确支持 Composer 2.x（例如腾讯云、阿里云均支持）
- 执行
composer diagnose，关注输出中 “The configured repository (packagist) is not canonical” 提示 - 若用自建镜像，确保 Nginx/Apache 返回正确的
Content-Encoding: gzip和Content-Type: application/json - 降级到 Composer 1.x 仅作验证，不建议长期使用（已停止维护）
镜像不是万能解药，关键得匹配版本、看清同步状态、别把临时网络抖动当成配置失败。真正卡住的时候，先 curl 看响应体，再查镜像站网页，最后翻 composer.json 里的 repositories 块——顺序错了，花半天调配置也没用。
