用一行命令切换 composer 国内镜像应执行：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，必须包含type值composer、键名repo.packagist（单数无s）、url以/结尾，缺一不可；生效前需运行composer clear-cache并验证输出。
如何用一行命令切换 Composer 国内镜像
直接执行这行命令就能切到阿里云镜像（国内最稳）：composer config -g repo.packagist https://mirrors.aliyun.com/composer/
这是全局配置，所有项目都会生效。如果你只想改当前项目，去掉 -g 参数，换成 composer config repo.packagist ...，但要注意：当前目录必须是已初始化的 Composer 项目（即存在 composer.json）。
为什么有时执行后没生效
常见原因不是命令写错，而是缓存或权限问题：
- Composer 会缓存 repo 元数据，切完镜像后建议清缓存：
composer clear-cache - 如果提示
Permission denied，说明全局配置文件~/.composer/config.json不可写，可手动检查该文件权限，或用sudo composer config -g ...（不推荐，易引发后续权限混乱） - 某些 IDE（如 PHPStorm）自带 Composer 封装，可能读取的是它自己的配置路径，需在 IDE 设置里同步关闭“Use composer from”或指向系统 composer
其他常用国内镜像地址及对应命令
不同镜像响应速度和同步频率略有差异，按需选用：
- 腾讯云：
composer config -g repo.packagist https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist https://repo.huaweicloud.com/repository/php/ - 清华大学（已停更，不建议新用）：
https://packagist.phpcomposer.com已失效，访问会 404
注意：repo.packagist 是固定键名，不能写成 packagist.org 或其他变体，否则配置无效。
想恢复官方源怎么办
执行这条命令即可还原：composer config -g --unset repos.packagist
别用 composer config -g repo.packagist https://packagist.org —— 这样只是换回域名，实际仍走 HTTP 重定向，不如直接删掉自定义配置，让 Composer 回退到默认逻辑。另外，--unset 的键名是 repos.packagist（带 s），不是 repo.packagist，这点极易拼错。
镜像切换本身很简单，真正卡住人的往往是缓存残留、权限错位、或键名拼写偏差——尤其是那个带 s 不带 s 的区别，多试两次就记住了。
