答案：Composer install卡在Downloading或报could not find package，主因是镜像配置错误——repo.packagist键名必须为单数、type值必须显式写composer、URL末尾必须带/，三者缺一即静默失效；且需执行composer clear-cache并验证config输出是否为完整JSON。
Composer install 卡在 Downloading... 或报 could not find package，基本不是你网络差，而是镜像根本没配对——键名、type 值、URL 斜杠三者错一个，命令就静默失效。
composer config -g repo.packagist 命令为什么总不生效
这条命令极易“看似执行成功，实则毫无作用”。关键点只有三个，缺一不可：
-
repo.packagist是固定键名，写成repos.packagist、packagist.org或mirror都无效 - 中间必须带
composer这个 type 值：正确写法是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；漏掉composer会 fallback 到默认源 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致 404）
验证是否真生效，只看这一条命令输出：composer config -g repo.packagist。输出应为完整 URL 字符串或 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）。如果返回空、null、https://packagist.org，说明根本没写进去。
项目级配置比全局更可靠，尤其在 CI/CD 和团队协作中
全局配置只对你当前用户生效，但宝塔用 www 用户、GitHub Actions 用 runner 用户、Docker 容器里可能是 root 或其他非登录用户——它们都读不到你本地的 /root/.composer/config.json。
立即学习“PHP免费学习笔记（深入）”；
进项目根目录（含 composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意去掉 -g）。
这条命令会自动在 composer.json 的 repositories 字段里安全追加，不覆盖已有私有源。改完后必须删掉 vendor/ 和 composer.lock，再跑 composer install（不是 update）。
如果项目已有 "repositories": [...]，别手动编辑 JSON——容易格式出错或误删私有源；坚持用命令追加。
换源后仍卡在 Resolving dependencies？那和镜像完全无关
镜像只加速下载阶段（Downloading），而 Resolving dependencies 是纯本地计算，不走网络。卡在这里，常见真实原因有：
-
composer.json里写了过于宽松的版本约束，比如"*"或"^1.0 || ^2.0"，触发求解器指数级穷举 - 启用了已废弃插件如
fxp/composer-asset-plugin（常见于老版 Yii2 项目），它额外请求 Bower/NPM 源，且不走 Composer 镜像配置 - PHP 内存不足（默认 128M 不够），可临时加
COMPOSER_MEMORY_LIMIT=-1 - Xdebug 开着，会让依赖解析慢 5–10 倍；可用
php -d xdebug.mode=off $(which composer) install临时禁用
此时 --repository-url 参数也无效，因为问题不在网络层。
临时换源排查问题，优先用 -vvv 看实际请求地址
不想动配置，或需要快速验证某个镜像是否可用，用临时参数最干净：
composer create-project topthink/think tp-demo --repository-url=https://mirrors.aliyun.com/composer/ -vvv
-vvv 不是可选项，它会打印每一步的真实 HTTP 请求地址，一眼就能确认是否真的走了镜像源。注意：--repository-url 只对 install、update、create-project 有效，require 命令不支持该参数。
别用已停用的旧镜像地址（如 https://packagist.phpcomposer.com），现在访问直接 404；阿里云、腾讯云、清华源三家目前同步稳定，任选其一即可。
