使用 composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 可设置全局镜像；必须加 -g 参数，键名固定为 repo.packagist，阿里云镜像推荐使用，清华源已停用。
composer
config 怎么改全局镜像地址
直接改全局配置最常用，命令是
。注意必须带
（global），否则只改当前项目，容易误以为生效了但新项目还是走官方源。
阿里云、腾讯云、华为云镜像都支持 HTTPS，推荐用阿里云：
；清华源已停止维护 Packagist 镜像，别再填
——会报
错误。
是固定键名，不能写成
或
如果之前设过其他镜像，这条命令会覆盖，不用先删
执行后不会输出任何提示，查是否生效：运行
，应返回你刚设的 URL
为什么 vendor install 还是慢 / 报 404
常见原因是 Composer 版本太老（/，比如填了
（带斜杠）可能触发 302 跳转失败。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
升级 Composer：
，确保是 2.x 最新版
检查镜像 URL 是否多写了
，正确写法是
（无尾部斜杠）
临时验证镜像可用性：手动 curl
，能返回 JSON 就说明镜像通
想只对某个项目换镜像，不碰全局
进项目根目录，去掉
参数，用
。这样只影响当前
同级目录下的操作，适合测试新镜像或隔离环境。
项目级配置会生成或修改
里的
字段，内容类似：
如果项目里已有自定义
，这条命令会合并而非覆盖，注意别出现重复 key 导致解析失败
删项目级镜像：用
，不是
config 命令改完没反应？先清缓存
Composer 会缓存
和包元数据，即使镜像地址改对了，旧缓存还可能拉取失败的响应，表现为反复报
或
。
清缓存命令：
，不是
（后者是旧版别名，新版已弃用）
缓存位置一般在
（Linux/macOS）或
（Windows），可手动删
清完缓存后首次
会稍慢，这是正常重建索引过程
镜像地址本身只是个入口，真正卡住的地方往往在缓存、版本兼容或 URL 末尾斜杠这种细节上。改完 config 别急着跑 install，先
，再
确认值对不对，两步缺一不可。
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/-ghttps://mirrors.aliyun.com/composer/https://packagist.phpcomposer.comCould not parse version constraintrepo.packagistpackagistmirrorcomposer config -g repo.packagisthttps://mirrors.aliyun.com/composer/composer self-update/https://mirrors.aliyun.com/composerhttps://mirrors.aliyun.com/composer/packages.json-gcomposer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composercomposer.jsoncomposer.jsonrepositories{"repositories": {"packagist.org": {"type": "composer", "url": "https://mirrors.tuna.tsinghua.edu.cn/composer"}}}repositoriescomposer config --unset repositories.packagist.org--unset repo.packagistpackages.jsonfile could not be downloadedfailed to open streamcomposer clear-cachecomposer cache-clear~/.composer/cache%APPDATA%\Composer\cachecomposer updateclear-cacheconfig -g repo.packagist