执行composer config -g repo.packagist后无输出，说明配置未生效，仍在直连https://packagist.org；真正有效验证方式是运行composer config -g repos.packagist（复数），应输出完整JSON对象如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 命令到底配没配成功？
执行 composer config -g repo.packagist 后没输出，不代表失败——它只在配置存在时才返回值；空输出说明你还在直连 https://packagist.org。真正有效的验证方式是运行 composer config -g repos.packagist（注意是 repos 复数），它会输出完整 JSON 对象，比如 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
常见误操作：
-
composer config -g repo.packagist（少个s）在 Composer 2.9+ 中静默失败，不报错也不提示 - 看到
composer diagnose显示 “OK”，就以为镜像生效——它根本不检查镜像源是否可用或元数据是否完整 - 全局配好了，但项目级
composer.json里还留着旧的"repositories"配置，结果被优先覆盖且不报错
项目级 repositories 配置怎么写才不踩坑？
项目级镜像必须用 "packagist" 作为 key，且 "type": "composer" 不可省略，否则 Composer 会忽略该配置、退回到官方源。
正确写法示例：
{
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
}
错误写法包括：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 把
"packagist"写成"packagist.org"或"default" - 漏掉
"type": "composer"，导致配置被跳过 - URL 末尾多加斜杠（如
https://mirrors.aliyun.com/composer//），部分镜像服务会 404
Docker 构建中 composer.lock 和镜像源顺序为什么不能乱？
构建慢不是因为网络差，而是缓存失效 + 镜像源没提前设好，导致每次 composer install 都要重试超时。
关键顺序必须是：
- 先
RUN composer config -g repo.packagist https://mirrors.aliyun.com/composer/ - 再
COPY composer.lock . - 然后
COPY composer.json . - 最后
RUN composer install --no-dev --optimize-autoloader
如果 composer.lock 在 composer.json 之后 COPY，Composer 会认为 lock 文件“不新鲜”，自动触发 update 行为，破坏可重现性。国内镜像源也必须在 COPY 前设置，否则第一轮请求仍走官方源并卡住。
阿里云、清华、SJTUG、php.cnpkg 四个源现在谁更稳？
截至 2026 年 7 月，这四个源都支持 HTTPS 和 Composer 2.9.6 协议，但适用场景不同：
-
https://mirrors.aliyun.com/composer/：华南/华东/华北用户延迟最低，Laravel/Symfony 包同步及时；小众 GitHub 私仓偶尔滞后 1–2 小时 -
https://mirrors.tuna.tsinghua.edu.cn/composer/：教育网和北方地区极快，但南方部分用户 DNS 解析不稳定；对 PHP 8.4 新语法兼容性验证更严，上线略晚 -
https://packagist.mirrors.sjtug.sjtu.edu.cn/：无商业节奏干扰，适合 CI/CD 流水线；需确认出口 IP 是否在教育网白名单，否则 403 -
https://php.cnpkg.org：更新最勤，Laravel 11 和 monorepo 类包几乎当天入库；文档弱，出问题只能靠社区反馈
别再用 https://packagist.phpcomposer.com 和 https://packagist.laravel-china.org——前者频繁 502，后者已停止维护，composer update 会直接报 Repository not found。
