Composer install卡在Loading或Downloading是因为未正确配置国内镜像源：键名必须为repo.packagist（非repos.packagist）、type值必须显式指定为composer、URL须以斜杠结尾，三者缺一即静默失效；验证需用composer config -g repo.packagist输出标准JSON且含正确URL，并配合composer install -vvv确认请求地址为镜像域名。
composer install 卡在 Loading composer repositories 或 Downloading，不是 ThinkPHP 插件本身慢，而是没走中文镜像——配错一个字符，就等于没配。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但根本没写进配置，ThinkPHP 的 topthink/think-queue、topthink/think-swoole 这类官方插件照样从 packagist.org 慢速拉取。原因就三个：
-
repo.packagist写成repos.packagist（多一个s）或packagist（少repo.），Composer 直接忽略，不存也不提示 - 漏掉中间的
composer——这不是可选参数，是必须显式的type值；写成composer config -g repo.packagist https://mirrors.aliyun.com/composer/就失效 - URL 缺末尾斜杠：
https://mirrors.aliyun.com/composer❌ 会拼出/composerpackages.json导致 404；必须是https://mirrors.aliyun.com/composer/✅
验证是否成功？只看这一行输出：composer config -g repo.packagist
正确结果必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍显示 https://packagist.org，说明没写进去。
ThinkPHP 项目里怎么安全加镜像，又不破坏私有插件源
ThinkPHP 生态常搭配公司内部插件（如 yourcorp/think-auth），用全局配置容易覆盖已有 repositories。推荐项目级操作：
- 进项目根目录（即含
composer.json的目录），运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 如果
composer.json原本是"repositories": {}，命令会自动转为数组并插入 packagist 条目 - 如果原本是
"repositories": [ ... ]（比如已配置了 Git 私有源），命令会追加到数组末尾，不会清空原有项 - 千万别手动写
"packagist.org": false在repositories里——它必须放在composer.json根节点，否则 ThinkPHP 扩展依赖（如ext-json）校验直接失败
改完立刻执行：composer update --lock，确保 composer.lock 记录的是镜像地址，否则 CI 部署时仍走官方源。
宝塔、Docker 或 GitHub Actions 里镜像为啥对 ThinkPHP 没用
ThinkPHP 应用部署在宝塔时，PHP 管理器默认以 www 用户执行 composer install，但你用 root 配的全局镜像存在 /root/.composer/config.json，www 根本读不到。
立即学习“PHP免费学习笔记（深入）”；
- 查真实用户：
sudo -u www whoami→ 确认是www - 给对应用户配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Docker 中若用
www-data用户，就得在 Dockerfile 里用USER www-data后再执行配置命令 - GitHub Actions 别用
sudo composer config -g，它写进 runner 的 root 配置，但 job 默认以普通用户运行；改用composer config -g+--no-interaction，或直接项目级配置更稳
验证是否真走镜像？加 -vvv 跑一次：composer require topthink/think-queue -vvv，日志里出现 GET https://mirrors.aliyun.com/composer/p2/topthink/think-queue/ 才算生效。
换镜像后 ThinkPHP 插件还是装不全？别怪镜像
镜像只加速 Downloading 和 Loading repositories 阶段，不解决 Resolving dependencies 卡顿。如果你发现 composer update 卡在这一步超过 30 秒，和镜像无关，常见 ThinkPHP 场景有：
-
composer.json里 PHP 版本写太宽："php": "^7.4 || ^8.0 || ^8.1 || ^8.2"，Composer 要试遍所有组合 - 用了未锁定的 dev 分支：
"topthink/framework": "dev-master"，每次都要重新解析整个分支历史 -
require-dev里塞了废弃插件，比如旧版fxp/composer-asset-plugin，它绕过镜像机制直接连 GitHub
这类问题换阿里云、清华、腾讯任一镜像都没用。临时解法是删 vendor/ 和 composer.lock，再 composer install；长期得收紧版本约束、固定 dev 分支哈希、移除废弃工具。
