composer config -g repo.packagist 命令必须严格写为 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，缺“composer”类型、多“s”、url非https或无末尾斜杠均导致镜像完全失效且不报错。
composer config -g repo.packagist 这条命令必须写对，否则镜像完全不生效——不是慢，是根本没走镜像。
为什么 composer config -g repo.packagist 总是静默失效
90% 的人配完镜像后依然卡在 Downloading，不是网络问题，是命令本身写错了，且 Composer 不报错也不提示。关键就卡在这三处：
-
repo.packagist不能拼成repos.packagist（多一个s就彻底无效） - 中间那个
composer是type值，不是可选参数：正确写法是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉它，Composer 2.0+ 会 fallback 回https://packagist.org - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，http://❌，https://mirrors.aliyun.com/composer（缺斜杠）❌——少斜杠会导致请求路径拼成/composerpackages.json，直接 404
验证是否写入成功？运行 composer config -g repo.packagist，输出必须是 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或至少是完整 URL 字符串；如果返回空、null、或仍是 https://packagist.org，说明没写进去。
全局配置 vs 项目级配置：谁更适合你当前场景
全局配置省事，但容易被环境覆盖；项目级配置写进 composer.json，拉代码即生效，行为可控。
- 个人开发或本地快速试用：用全局配置，执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 团队协作、CI/CD、宝塔或 Docker 环境：全局配置靠不住——宝塔默认以
www用户运行，root下配的配置它读不到；GitHub Actions、Docker 容器也各自有用户上下文。此时必须进项目根目录，执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），它会自动往composer.json的repositories字段里追加，不覆盖已有私有源 - 已有私有源（如 Git 仓库或 Satis）？别跑命令，手动编辑
composer.json，在repositories数组里加一条"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，并确保顶层有"packagist.org": false
换镜像后还是卡？先看日志卡在哪一步
镜像只加速下载环节（Downloading、GET https://mirrors.aliyun.com/composer/），不解决依赖解析慢的问题。
- 如果
composer install -vvv输出里大量出现GET https://mirrors.aliyun.com/composer/或Downloading xxx.zip→ 镜像已生效，下载正在加速 - 如果长时间停在
Resolving dependencies（尤其超过 10 秒）→ 和镜像无关，典型原因是："php": "^7.4 || ^8.0"这类宽泛约束、require-dev包太多、启用了xdebug、或composer.lock被删导致退化为update - 命令根本没发出请求，而是报
Could not open input file: composer或putenv() has been disabled→ 环境问题，检查 PATH 或php.ini中的disable_functions
换源后首次安装失败？删 vendor 和 lock 再来
镜像元数据可能有缓存延迟或同步差异，旧 composer.lock 记录的是官方源的哈希值，和新镜像返回的内容不匹配。
- 首次切换镜像后，若出现
hash does not match、package is not installed或could not find package，直接删掉vendor/目录和composer.lock文件 - 再执行
composer install（不是update），让 Composer 重新从镜像拉取元数据并生成新 lock 文件 - CI/CD 中建议固定使用
--no-dev --prefer-dist --optimize-autoloader，避免因 dev 包或 git clone 拖慢构建
最常被忽略的点：镜像只管“下载”，不管“算依赖”。很多人盯着 composer config 反复重试，却没意识到卡在 Resolving dependencies 时，换十个镜像也没用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
