Composer config -g repo.packagist 命令总不生效是因为字段名（必须单数repo.packagist）、类型参数（必须显式传入composer）、URL格式（必须https://开头且结尾带/）三者缺一不可，任一错误即静默回退官方源且不报错。
composer config -g repo.packagist 命令为什么总不生效
不是 Composer 拒绝执行，是它静默忽略错误配置——字段名、类型参数、URL 格式三者缺一不可，错一个就 fallback 回 packagist.org，且完全不报错。
-
repo.packagist不能写成repos.packagist（多一个 s 就失效） - 第二个参数必须是
composer（声明仓库类型，漏掉则视为无效配置） - URL 必须以
https://开头，且结尾带/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌ - 验证是否写入成功：
composer config -g repo.packagist输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}或纯 URL 字符串；若为空、null或仍显示https://packagist.org，说明没生效
阿里云镜像 vs 腾讯云镜像：选哪个更稳
阿里云镜像（https://mirrors.aliyun.com/composer/）和腾讯云镜像（https://packagist.proxy.tencent.com/）目前都可用，但稳定性有差异：Laravel China 镜像自 2025 年底起频繁返回 502/503，已不推荐；华为等小众镜像同步延迟高、节点少，容易卡在 Loading composer repositories。
- 阿里云响应快、节点广，适合绝大多数场景，命令为：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云镜像需额外配
http.timeout和process-timeout才能避免超时，且必须验证连通性：curl -I https://packagist.proxy.tencent.com/packages.json应秒回HTTP/2 200 - 两者都不支持
"prefer-source": true场景——此时 Composer 直连 GitHub/GitLab，镜像完全不介入，超时仍是 Git 层问题
http.timeout 和 process-timeout 到底该设多少
这两个参数控制不同阶段，混用或只调一个基本无效。看到 cURL error 28 或 Could not fetch 是 http.timeout 不够；看到 The process timed out 卡在解压或脚本执行，才是 process-timeout 的事。
-
http.timeout控制单次 HTTP 请求（DNS + TCP + TLS + header），默认 60 秒，建议设为600：composer config -g http.timeout 600 -
process-timeout控制整条命令生命周期（含依赖解析、下载、解压、post-install-cmd），默认 300 秒，大项目建议设为1200：composer config -g process-timeout 1200 -
http-basic.timeout是 Composer v1 废弃项，v2+ 完全不读取；--timeout=600只影响命令总周期，对 HTTP 下载阶段无效
PhpStorm 或 CI 环境里镜像为啥不起作用
PHPStorm 不自带 Composer，它只是调用你指定的可执行文件；CI 容器每次启动都是干净环境，COMPOSER_HOME 若未固化，全局配置就丢了。
立即学习“PHP免费学习笔记（深入）”；
- PHPStorm 中检查 Settings → PHP → Composer → Path to composer.phar，确保路径和终端运行
which composer一致；宝塔用户常混淆/usr/local/bin/composer和/www/server/php/82/bin/composer - CI 构建脚本开头必须显式执行镜像配置命令，不能依赖“之前配过”
- 项目级
composer.json中的repositories字段会覆盖全局配置，尤其当硬编码了packagist.org或错误 URL 时，镜像完全不生效 - 务必执行
composer clear-cache，否则旧缓存仍可能从旧源拉取
