Composer镜像配置必须严格满足三要素：键名repo.packagist、type值composer、URL为HTTPS且结尾带/；错一处即fallback至官方源，需验证JSON输出并清缓存、删vendor与composer.lock后用--no-cache重装。
配错一个字符，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/，结尾必须有/）
最易被忽略的是缓存残留和权限错位——CI 脚本用 www 用户执行，但你配的是 root 的全局 config；或者 composer.lock 没删干净，导致哈希校验失败。这些地方一卡，换再快的镜像也没用。
