最直接确认方法是运行 composer config -g repo.packagist，若输出为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 则已生效；否则未切换成功或被覆盖。
怎么确认当前用的是不是阿里云镜像
最直接的办法是运行 composer config -g repo.packagist。如果输出是 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，说明已生效；如果返回空、报错，或显示 "url": "https://packagist.org"，那还没切过去，或者被其他配置覆盖了。
常见错误现象：
- 执行完命令后
composer install还卡在repo.packagist.org—— 很可能是漏了-g，只改了当前项目，没动全局 - 输出里有
"allow_ssl_downgrade": true—— 这是旧版 Composer 的残留字段，说明配置可能混用了新旧写法，容易导致失效 - Windows 下用 PowerShell 执行后，在 CMD 里验证没变化 —— 配置已写入，但终端没刷新环境变量，重开一个终端再试
全局切换到阿里云镜像的正确命令
Composer 2.0+ 推荐用 repos.packagist.org 键名，但目前仍广泛兼容 repo.packagist（注意是单数 repo，不是 repos）。阿里云地址必须以 https:// 开头、结尾带 /，否则会 404 或报 Invalid repository type。
直接运行这行命令即可：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会写入 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows），之后所有项目自动走阿里源。
关键点：
- 别用
mirror字段 ——composer config -g mirror是无效的，官方根本不识别这个配置项 - 别加
--unset后再设，除非你明确想先清掉旧配置；重复执行本命令会安全覆盖，不会出错 - URL 末尾少个
/，某些版本会静默失败，建议复制时核对
为什么换完还是走官方源？优先级和缓存问题
Composer 的源配置有明确优先级：项目级 repositories > 全局 repo.packagist > 默认官方源。哪怕你全局配好了，只要项目根目录的 composer.json 里有 "repositories" 字段，就会优先生效。
常见干扰场景：
- 项目
composer.json中存在"repositories": { "packagist": { ... } }—— 删除该段或手动改成阿里云地址 - 执行过
composer config repo.packagist ...（无-g）—— 它会把配置写进项目composer.json，覆盖全局设置 - 本地缓存没清，元数据还指着旧地址 —— 必须补一句
composer clear-cache - 用
sudo composer config -g写进了 root 用户的配置，而日常用普通用户运行 —— 检查~/.composer/config.json所属用户是否匹配
如何临时切回官方源或换腾讯云
不想动全局配置？可以用 --repository 参数单次指定源，比如：
composer update --repository=https://mirrors.cloud.tencent.com/composer/
想彻底还原官方源，运行：
composer config -g --unset repo.packagist
之后 composer config -g repo.packagist 应该返回空，composer diagnose 会显示 Repo packagist.org: https://packagist.org。
注意：
-
--unset是唯一干净还原的方式；手动删config.json里的字段容易格式出错，导致后续所有composer命令失败 - 腾讯云地址是
https://mirrors.cloud.tencent.com/composer/，结尾/composer/不能写成/composer，否则 404 - 阿里云镜像不支持上传私有包，纯下载加速场景下它仍是目前最稳的选择，同步延迟极低，基本不存在“搜不到新版”的情况
真正麻烦的不是命令记不住，而是改完没清缓存、没检查项目级配置、或者在多用户环境下权限写错位置 —— 这些地方一错，就以为命令失效，其实只是没生效到你正在跑的那个上下文里。
