composer全局镜像配置失败主因是未初始化全局配置或权限问题；需用composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/正确设置，注意键名、type值及url结尾斜杠。
Composer全局镜像源配置失败的常见原因
直接改 composer.json 里的 repositories 只对当前项目生效，不是“全局”；用 composer config -g repo.packagist 命令却报错 Could not find package composer/composer，大概率是未初始化全局配置文件或权限问题。Debian 默认没预装 Composer 配置目录，~/.composer/config.json 可能根本不存在。
用 composer config -g 正确设置阿里云镜像
先确保 Composer 已安装且可执行（composer --version 能输出版本）。然后运行以下命令：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动创建 ~/.composer/config.json 并写入镜像配置。注意三点：
-
repo.packagist是固定键名，不能写成packagist或repository -
composer是 type 字段值，必须小写、必须存在，缺了会回退到官方源 - URL 结尾的
/不能省，否则某些旧版 Composer（如 1.x）会拼出错误路径
验证镜像是否生效及快速排障
运行 composer config -g repo.packagist 查看当前配置；再执行 composer show -p | head -5，观察下载 URL 是否含 mirrors.aliyun.com。如果仍走官网，检查：
- 当前用户家目录下是否有
.composer目录且权限为 755（ls -ld ~/.composer） - 是否在 root 下执行过
composer config -g，而普通用户调用时读的是自己的配置 - 是否存在项目级
composer.json中覆盖了repositories，它优先级高于全局
切换回官方源或换其他镜像（如腾讯云）
还原官方源只需删掉全局配置项：
composer config -g --unset repo.packagist
换成腾讯云镜像则用：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
注意：国内镜像偶尔同步延迟（尤其新发布的包），若遇到 Package not found 且确认包存在，可临时加 -vvv 看实际请求地址，或临时禁用镜像试 composer install --no-cache。
真正容易被忽略的是：Debian 的 sudo composer 和普通用户 composer 使用的是完全隔离的全局配置，切勿混用；另外，Docker 容器内配置需在构建阶段写入，不能依赖宿主机的 ~/.composer。
