真正起效的是镜像+缓存+并发三者对齐；漏掉任意一项，composer install就会删vendor重来，因配置错误（如URL缺/、键名错为repos.packagist）、缓存未启用或未挂载、并发未设置、项目级repositories覆盖全局配置等均导致静默失效。
改 Composer 配置本身不提速，真正起效的是镜像 + 缓存 + 并发三者对齐；漏掉任意一项，composer install 就会删 vendor 重来。
为什么改了 config.json 却没效果？
手动编辑 ~/.composer/config.json 或 ~/.config/composer/config.json 几乎总是白忙——Composer 启动时会校验 JSON 格式，遇到多逗号、单引号、中文标点或路径权限问题，直接跳过整个文件，且不报错。
-
composer config --global --list --verbose才能确认当前实际生效的配置路径和内容 -
--global参数不可省略，漏掉就会写进当前项目composer.json，不是全局生效 - 若
COMPOSER_HOME指向空目录或不可写路径，composer config --global表面成功，实际没写入
全局镜像配置必须满足三个硬条件
只执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 不够，以下任一缺失都会导致静默失效：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- URL 必须以
/结尾（如https://mirrors.aliyun.com/composer/），缺了就解析失败 - 键名必须是
repo.packagist，写成repos.packagist（多一个 s）或repository.packagist都无效 - 必须同时启用并发：
composer config -g parallel-downloads 8（设为 10 容易触发file_put_contents(/tmp/): failed to open stream）
CI/CD 和 Docker 环境下不能依赖“一次配置”
干净容器里没有全局配置，Docker 构建时若未挂载缓存目录，每次都是全新下载。临时写入才是可靠做法：
- GitHub Actions / GitLab CI 中，命令前加临时配置：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ && composer install --no-dev --prefer-dist - Dockerfile 中必须分步：
COPY composer.json composer.lock ./→RUN composer install --no-dev --prefer-dist→ 再COPY其他代码，否则层缓存失效 -
docker-compose.yml必须挂载缓存：volumes: - ~/.composer/cache:/root/.composer/cache，否则多项目无法复用已下载包
缓存路径未设置或不可写，等于没配镜像
composer config -g cache-files-dir 输出为空，说明缓存根本没启用——所有包下载后不落盘，下次必重来。
- 验证缓存是否启用：
composer config -g cache-dir应输出有效路径，且该路径需可写 - 项目
composer.json中若存在空"repositories": {}，会静默屏蔽全局镜像，实际走packagist.org，缓存命中率归零 -
composer.lock中platform段声明"php": "8.1"，而本地 PHP 是 8.2，Composer 认为环境不兼容，强制重建vendor/
最常被忽略的一点：大型项目依赖链深，哪怕只有一个小包的 dist checksum 变了，或者缓存目录权限在 CI 节点上被重置，整个构建流程就会退回到“全量重装”状态。
