repositories字段一出现即完全屏蔽全局镜像；必须将{"packagist.org": false}作为独立对象置于数组首位，镜像url末尾须带/，且仅404触发fallback，超时或502直接报错。
repositories字段一出现，全局镜像就失效
只要项目根目录的composer.json里存在repositories字段（哪怕只是"repositories": []），Composer 就会彻底忽略composer config -g repo.packagist设的全局镜像。这不是“优先级更高”，而是直接屏蔽——全局配置此时形同未设置。
常见踩坑点：
- CI 流水线脚本自动生成空
"repositories": []，导致构建时仍连packagist.org - 误执行
composer config repo.packagist（漏-g），结果把镜像写进了当前项目的repositories数组，变成项目级覆盖 -
composer create-project拉的模板自带repositories字段，你刚配好的全局镜像根本没机会触发
{"packagist.org": false}必须独立、靠前、拼写精确
不加这行，Composer 会在你所有声明的镜像查完后，自动追加官方源作为兜底——这在墙内基本等于卡死或失败。它不是可选优化项，而是硬性前提。
关键细节：
- 必须是
repositories数组里的一个独立对象，不能塞进其他对象内部 - 必须放在数组第一个位置，否则可能被后续条目覆盖语义（Composer 解析顺序依赖位置）
- 键名必须是
"packagist.org"，写成"packagist"、"packagist.com"或"packagist.org": true都无效 - 值必须是
false，不是null或字符串"false"
镜像 URL 末尾必须带 /，否则路径拼接出错
Composer 拼接元数据路径时，会把url和子路径（如/packages.json）直接拼接。如果 URL 缺少末尾/，就会变成https://mirrors.tuna.tsinghua.edu.cn/composerpackages.json，直接 404。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
正确写法示例：
"repositories": [
{"packagist.org": false},
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
]
错误写法（全部失效）：
-
"url": "https://mirrors.aliyun.com/composer"（缺/） -
"url": "https://mirrors.aliyun.com/composer/packages.json"（多加了路径） -
"url": "http://...（非 HTTPS，部分镜像已弃用 HTTP）
多个镜像不会自动 fallback，只按顺序逐个试 404
Composer 不会“测速选快”或“失败即切”。它对每个包只做一件事：从repositories数组第一个元素开始请求packages.json；只有当该请求明确返回 HTTP 404（包确实不存在），才尝试第二个；若第一个返回 500、超时、TLS 错误或 DNS 失败，直接报错，不再往下走。
这意味着：
- 阿里云镜像服务端卡住 → 等满默认 30 秒才报错，腾讯云镜像完全不被访问
- 阿里云镜像尚未同步新包 → 返回 404 → 才轮到腾讯云，但后者也可能没同步，最终仍失败
- 想缓解超时卡顿，得全局调大超时：
composer config -g http.timeout 600 - 多镜像无法替代可用性检测，真实场景需外部脚本（如
curl -I）预判源是否可用
vendor 和 composer.lock 是绕不开的步骤——lock 文件里存的是 dist URL 哈希，不删它，Composer 就按旧地址直连，根本不会读你新配的 repositories。
