配置Composer中文镜像，优化你的Composer配置文件！-composer-PHP中文网

composer镜像配置必须严格满足三要素：键名repo.packagist、type值composer、url为https且结尾带/；错一处即fallback至官方源，需验证json输出并清缓存、删vendor与composer.lock后用--no-cache重装。

配置composer中文镜像，优化你的composer配置文件！

配错一个字符，Composer 就当没这回事——不报错、不提示、照连 packagist.org。镜像配置不是“试试看”，是必须严格满足三要素：键名 repo.packagist、type 值 composer、URL 必须 HTTPS + 末尾 /。

composer config -g repo.packagist 命令写不对就等于没配

这条命令静默失效的常见写法包括：repos.packagist（多一个 s）、漏掉中间的 composer、URL 写成 https://mirrors.aliyun.com/composer（少斜杠）。只要错一处，Composer 2.x 就自动 fallback 到官方源，你根本察觉不到。

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 是唯一正确格式
执行后必须运行 composer config -g repo.packagist 验证输出——应为完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果输出是空、null、或只显示 URL 字符串但域名仍是 packagist.org，说明配置失败

项目级配置比全局更可靠，尤其在 CI/CD 和宝塔环境中

全局配置写在 ~/.composer/config.json，但宝塔、GitLab Runner、Docker 构建常以 www 或 runner 用户运行，读不到 root 的配置；团队协作时也难以保证所有人环境一致。

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

进项目根目录，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
该命令会自动向 composer.json 的 repositories 字段追加 packagist 条目，不覆盖已有私有源
若项目已有 "repositories": {}，命令会转为标准对象结构；若已是数组，会安全追加新项
切勿手动编辑 composer.json 里的 repositories——JSON 格式错一个逗号，composer install 直接报错

换源后仍卡在 Downloading？清缓存 + 强制走新源

镜像只加速下载，但旧缓存里存着 packagist.org 的元数据。Composer 优先读缓存并尝试从旧地址校验，结果就是卡在 DNS 或 TLS 握手——不是没走镜像，是根本没发请求过去。

先执行：composer clear-cache
删掉 vendor/ 和 composer.lock
再跑：composer install --no-cache（禁用缓存，强制走新源）
composer.lock 记录的是旧源的包哈希，和镜像返回的元数据不兼容，保留它必报 hash does not match

验证是否真走镜像，不能只看 config 输出

composer config -g repo.packagist 显示 URL 没用，得看到网络请求实际打到镜像域名才算数。

实测命令：composer show monolog/monolog -vvv 2>&1 | grep "Downloading"
日志里必须出现 mirrors.aliyun.com 或 mirrors.cloud.tencent.com 等镜像域名
如果看到 https://packagist.org 或 repo.packagist.org，说明 fallback 触发了，配置没起作用
华为云镜像地址是 https://mirrors.huaweicloud.com/repository/php/composer/（注意路径含 /repository/php/composer/，结尾必须有 /）