composer切换网易镜像需执行composer config -g repo.packagist composer https://mirrors.163.com/composer/，严格满足-g、单数键名、type值composer及url末尾斜杠四要素，再运行composer clear-cache并用composer config -g repo.packagist验证输出。
Composer 默认走国外源，国内直连 packagist.org 极慢甚至超时，直接改全局配置指向网易镜像站是最简单有效的加速方式。
确认当前 Composer 镜像源是否生效
执行 composer config -g repo.packagist 查看当前全局配置。如果返回 {"type": "composer", "url": "https://packagist.org"} 或为空，说明没换源，需要手动设置。
注意：不要依赖 composer global show 或 composer diagnose 判断镜像是否生效——它们不显示 repo 配置细节，容易误判。
用命令行一键切换到网易镜像站
运行以下命令即可覆盖全局配置：
composer config -g repo.packagist composer https://mirrors.163.com/composer/
这条命令做了三件事：
- 修改全局
composer.json（通常在~/.composer/config.json） - 把
repo.packagist设为 typecomposer+ urlhttps://mirrors.163.com/composer/ - 后续所有
composer install、composer update都自动走网易镜像
验证是否成功：执行 composer config -g repo.packagist，应输出类似：
{"type": "composer", "url": "https://mirrors.163.com/composer/"}
遇到 Could not fetch 或 404 错误怎么办
常见原因不是镜像站问题，而是本地缓存或 Composer 版本兼容性：
-
composer clear-cache清掉旧缓存，再试 - 如果你用的是 Composer 2.5+，网易镜像站已完全支持；但 Composer 1.x 用户需确保版本 ≥ 1.10.22，否则部分包元数据解析失败
- 某些私有包或未同步的 dev 分支可能不在镜像中——这时会 fallback 到原站，但不影响主流程；可临时加
--prefer-source绕过 - 别手动编辑
~/.composer/config.json后忘记加逗号或引号，JSON 格式错误会导致所有composer命令报错
项目级临时换源（不改全局）
某些团队要求项目内独立控制源，或者你不想影响其他项目：
- 进入项目根目录，运行
composer config repo.packagist composer https://mirrors.163.com/composer/ - 该配置写入项目级
composer.json的config.repo字段，只对当前项目生效 - 注意：项目级配置优先级高于全局，但一旦删掉项目
composer.json里的config段，就退回到全局设置
网易镜像站本身不提供认证或私有仓库代理，所以它只加速公开包；如果你同时用了私有 Packagist 服务，需单独配置 repositories 数组，不能指望镜像站透传。
