镜像源切换失效主因是配置未真正生效，而非镜像宕机；常见错误包括键名写错、缺失type值、url缺尾部/、项目级repositories屏蔽全局配置，需三处一致（config输出、diagnose结果、-vvv日志）并清缓存验证。
镜像源切换总失效，90% 是因为配置没真正“生效”，而不是镜像本身挂了。 Composer 不会报错、不提示、不 fallback，写错一个字母或漏一个斜杠，它就安静地退回 packagist.org —— 你看到的“慢”“超时”“Could not fetch”，几乎全是配置未命中导致的假性故障。
composer config -g repo.packagist 为什么静默失败
这条命令看似执行成功，实则常因三个硬伤直接失效：
-
repo.packagist写成repos.packagist（多一个 s）或repositories.packagist.org（新版键名），Composer 2.2+ 会完全忽略，且不报错 - 漏掉
composer这个type值：命令必须是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，少composer就 fallback 到官方源 -
url缺尾部/：写成https://mirrors.aliyun.com/composer会导致路径拼接为/composerpackages.json，返回 404，Composer 自动弃用该镜像
验证是否真写入：运行 composer config -g repo.packagist，输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明根本没落盘。
项目级 repositories 字段会彻底屏蔽全局配置
只要项目根目录 composer.json 里存在 "repositories" 字段（哪怕只是空数组 "repositories": []），全局的 repo.packagist 或 repositories.packagist.org 就完全失效 —— Composer 的优先级规则是“项目级 > 全局”，没有协商，没有 fallback。
- 检查命令：
composer config repositories，如果输出里还有https://repo.packagist.org，说明项目配置正在接管 - 临时禁用项目配置：
composer config --unset repositories（慎用，可能影响私有包） - 安全追加镜像（推荐）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/，它会自动 merge 到composer.json的repositories对象中，不覆盖已有私有源
注意："packagist.org": false 必须作为 repositories 数组里的独立对象项，不能嵌套，也不能拼成 "packagist" 或 "packagist.com"。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
换源后仍请求 packagist.org？三处必须一致才可信
别信命令回显，要看真实行为。必须同时满足三处一致，才算镜像真正启用：
-
查配置：
composer config -g repo.packagist或composer config -g repositories.packagist.org输出必须是你设的镜像 URL（结尾带/） -
看诊断：
composer diagnose找 “Repo:” 行，域名必须匹配，例如Repo: https://mirrors.aliyun.com/composer/ -
抓请求：
composer install -vvv日志中所有Downloading行的 URL 必须含镜像域名；更准的是composer show -p | head -3，第一行显示的源域名要是你配的
漏掉 composer clear-cache，本地缓存的元数据仍指向旧地址；没删 vendor/ 和 composer.lock，lock 文件里记录的 hash 可能和镜像元数据不一致，导致降级回源。
临时切源比永久配置更可靠，尤其在 CI 和调试时
全局配置容易污染环境、难追溯、多用户场景下易错位（比如你在 root 下配了，CI 却用 www 用户跑）。临时参数优先级最高，绕过所有配置：
- 单次强制走某镜像：
composer install -vvv --repository-url=https://mirrors.huaweicloud.com/repository/php/composer/ - 创建项目时指定：
composer create-project laravel/laravel myapp --repository=https://mirrors.cloud.tencent.com/composer/ - 仅当前项目生效（不改
composer.json）：composer config repo.packagist composer https://mirrors.ustc.edu.cn/composer/
注意：--repository-url 只对 install、update、require 生效，不适用于 create-project（得用 --repository）。
最常被忽略的一点：Composer 的“镜像”只加速下载，不解决依赖解析卡顿。如果你的 composer update 卡在 Resolving dependencies 阶段几十秒不动，和镜像无关，该收紧 php 版本约束、删掉 minimum-stability: dev、或锁定 require-dev 里的工具链版本。
