composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名严格为单数 repo.packagist、中间必须显式指定 type 值 composer、url 必须 https 且末尾带 /；任一缺失即静默回退官方源，验证需输出完整 json 对象如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 命令为什么总不生效
这条命令看似执行了，但实际没写进全局配置，是 Composer 下载慢最常被误判的“假成功”。它不报错，也不提示失败，只默默 fallback 回 https://packagist.org。
必须同时满足三个硬条件：
-
repo.packagist不能写成repos.packagist（多一个 s 就彻底忽略） - 中间必须带
composer这个 type 参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅；漏掉composer就是错的 ❌ - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅；少斜杠会拼出https://mirrors.aliyun.com/composer/packages.json这类错误路径，返回 404
验证是否真生效：运行 composer config -g repo.packagist。输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍含 packagist.org，说明根本没写进去。
换源后还卡在 Downloading，最常被跳过的一步
镜像配置正确 ≠ 立刻加速。Composer 会优先读本地缓存里的旧元数据，哪怕你已改好配置，它仍试图从 packagist.org 拉校验信息，结果卡在 DNS 或 TLS 握手阶段。
必须立刻执行：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
composer clear-cache—— 清掉所有本地缓存，强制重新拉取镜像站数据 - 如果项目已有
vendor/和composer.lock，建议一并删掉再跑composer install，避免残留干扰 - 验证是否真走镜像：运行
composer show laravel/framework -vvv 2>&1 | grep "Downloading"，日志里必须出现mirrors.aliyun.com或对应镜像域名
http-max-concurrent-downloads 和 parallel-downloads 的区别
这两个参数名字像，但新版 Composer（2.2+）只认 http-max-concurrent-downloads，parallel-downloads 已弃用且静默无效。
设值推荐 8–10：
composer config -g http-max-concurrent-downloads 10- 必须同步加大超时：
composer config -g http.timeout 300和composer config -g process-timeout 3600 -
http-max-concurrent-downloads只对composer install有效；composer update因依赖图计算本身串行，几乎不受影响 - 设成 20 容易触发本地文件竞争或镜像限流，典型报错是
file_put_contents(/tmp/): failed to open stream
CI/CD 或宝塔环境里配置不生效的真正原因
全局配置写的是 root 用户的 /root/.composer/config.json，但宝塔、CI 构建或计划任务常以 www 用户运行，根本读不到 root 的配置。
解决办法是切到对应用户下执行：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/- 同理，
composer clear-cache也得用同一用户执行，否则清的是 root 的缓存 - 项目级配置虽能绕过用户问题，但会覆盖全局设置，团队协作中容易引发行为不一致
真正卡住的地方往往不是网络，而是缓存没清、用户权限错位、或并发参数设错——这些点一旦漏掉，换再快的镜像也没用。
