phpenv下Composer全局换源需用composer config -g命令配置，如composer config -g repo.packagist https://mirrors.aliyun.com/composer/，并清除旧配置、验证生效，同时确保dist镜像和CLI环境正常。
直接改 composer config -g 就行，别碰 composer.json 里的 repositories 字段——它只影响当前项目，而 phpEnv 是多项目共用的本地开发环境，必须走全局配置才真正生效。
phpEnv 下 composer 全局换源命令必须带 -g
phpEnv 本身不干预 Composer 行为，但它默认让所有项目共享系统级 Composer 配置。所以换源必须用全局模式：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/- 如果之前手动加过其他镜像（比如腾讯云或自定义源），先运行
composer config -g --unset repos.packagist清掉旧配置再重设 - 执行后立刻验证：
composer config -g repo.packagist应该输出https://mirrors.aliyun.com/composer/，而不是空或报错
下载还是慢？大概率没走 dist 镜像
阿里云镜像虽快，但 Composer 默认会从 dist（压缩包）和 metadata（包信息）两个路径拉数据。只配了主源，dist 还可能直连 github.com 或 packagist.org，导致卡在 Downloading zip 阶段。
- 确认
repos.packagist类型是composer：composer config -g repos.packagist.type输出应为composer - 删掉项目
composer.json里任何硬编码的"dist-url"字段——它会强制覆盖镜像的 dist 映射 - 验证是否真走镜像：运行
composer update -vvv，盯住日志里Downloading http开头的 URL，域名必须是mirrors.aliyun.com
phpEnv 环境下常见失败原因
phpEnv 自带 PHP CLI，但常因权限或函数禁用导致 Composer 启动失败，进而让换源操作看似“没反应”：
立即学习“PHP免费学习笔记（深入）”；
- 检查
php -m | grep -E "openssl|tokenizer"，缺任一模块都会让 Composer 直接退出 - 确认
putenv、proc_open没被禁用（尤其 Windows 下 phpEnv 的 ini 文件里容易漏掉） - 如果
composer --version报错，先别急着换源，先解决 CLI 环境问题——否则换源命令根本执行不了 - 某些 phpEnv 版本默认把 Composer 安装在用户目录，
composer config -g写入的是~/.composer/config.json，确保该路径可写
最易忽略的一点：换源后第一次 composer install 仍可能慢——因为 composer.lock 里记录的是旧 dist URL，Composer 会先尝试按 lock 文件去拉包；只要锁文件没更新，它就不会主动切到新镜像的 dist 地址。遇到这种情况，删掉 vendor 和 composer.lock，再跑 composer install 才能彻底走通阿里云全链路。
