不存在叫 composer-pkg 的官方镜像或配置项，正确配置是 repo.packagist 键名、type 值为 composer、url 为带尾斜杠的 https 地址，三者缺一即静默回退官方源。
直接说结论：不存在叫 Composer-pkg 的官方镜像或配置项，这是常见误传——你真正要配的是 Packagist 镜像，键名必须是 repo.packagist，类型值必须是 composer，URL 必须带尾斜杠且为 HTTPS。
为什么 composer config -g repo.packagist 总是不生效
不是镜像地址挂了，而是命令写错三个硬性条件，Composer 会静默 fallback 到官方源，连错误都不报：
-
repo.packagist是固定键名，写成repos.packagist（多 s）、packagist.org或composer-pkg都无效 - 第二个参数
composer是type字段值，不是命令名，漏掉就等于没配 - URL 必须以
https://开头，且末尾必须有/，例如https://mirrors.aliyun.com/composer/✅，少斜杠会触发 404 - 必须加
-g（global），否则只改当前目录的composer.json，换项目就失效
composer config -g repo.packagist 执行后怎么确认真生效
别信命令输出，要看真实网络请求：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g repo.packagist，输出应为类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；如果为空、null或报错，说明没写对 - 更可靠的方式：执行
composer clear-cache && composer show monolog/monolog -vvv 2>&1 | grep "Downloading\|GET"，观察 URL 是否含mirrors.aliyun.com或mirrors.cloud.tencent.com - 若日志里出现
packagist.org或repo.packagist.org，说明被项目级repositories覆盖了，进项目目录运行composer config repo.packagist查看是否为空
项目里有 repositories 字段，全局镜像还管用吗
不管用。Composer 的仓库优先级是硬编码的：项目级 > 用户级（~/.composer/config.json） > 全局默认源。只要项目根目录的 composer.json 含 "repositories" 数组，哪怕只有一行 {"packagist.org": false}，全局配置就彻底失效。
- 常见陷阱：团队模板自带
"repositories": [{"type": "composer", "url": "https://packagist.org"}]，一拉代码就废掉你的阿里云镜像 - 临时验证镜像是否可用，绕过所有配置：用
--repository-url参数，例如composer update --repository-url=https://mirrors.tencent.com/composer/ - CI/CD 中建议弃用全局配置，改用环境变量：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install
现在还能用的镜像地址（2026 年实测有效）
旧地址如 packagist.phpcomposer.com 已大规模返回 404，清华源同步延迟明显，推荐以下三个：
- 阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（稳定性最高，同步频率 15 分钟） - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/（Laravel 生态缓存更及时） - 华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/（企业级 SLA，适合生产环境）
注意：所有地址必须用 HTTPS，且末尾带 /；Windows 用户若提示权限错误，需以管理员身份运行终端，或改用项目级配置。
