Composer如何恢复默认官方镜像源（命令介绍）-composer-PHP中文网

composer config -g --unset repos.packagist 不生效是因为键名应为 repo.packagist（单数），repos.packagist（复数）是已弃用的旧键名，删除它不影响当前镜像配置；且删后需清缓存、检查项目级 repositories 及环境变量，否则仍走旧镜像。

composer如何恢复默认官方镜像源（命令介绍）

composer config -g --unset repos.packagist 为什么有时不生效

这条命令本意是删掉全局镜像配置，让 Composer 自动 fallback 到 https://packagist.org，但它只在“字段名写对 + 没其他干扰”时才可靠：

必须用 repos.packagist（复数 repos），写成 repo.packagist（单数）不会报错，但删的是另一个字段，实际没动到镜像源
旧版 Composer（如 2.2–2.4）删掉该字段后，可能因 fallback 逻辑缺陷卡住，报 Could not parse version constraint 或直接 hang 住
删完不等于立刻切换——缓存里还存着镜像的 packages.json 快照，composer update 仍会读旧数据，导致包找不到、版本错乱
即使全局删干净了，只要项目根目录的 composer.json 里有 "repositories" 块，它就优先生效，完全无视全局设置

composer config -g repo.packagist composer https://packagist.org 更稳

比起删配置，直接覆盖更可控，尤其适合 Composer 2.0+ 全版本（包括已知有问题的 2.2–2.4 小版本）：

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 composer https://packagist.org，明确告诉 Composer：“所有元数据都从这个地址拿”
字段名必须是 repo.packagist（单数），这是 Composer 2.0+ 唯一认的键名；repos.packagist 已被弃用，设了也无效
如果之前混用过两种写法，建议先清理：分别执行 composer config -g --unset repos.packagist 和 composer config -g --unset repo.packagist
仅当前项目临时切回？进项目目录后运行 composer config repo.packagist composer https://packagist.org（不加 -g）

composer clear-cache 不是可选项，是硬性前置步骤

换源后不执行 composer clear-cache，Composer 仍会读取缓存里旧镜像下载的 packages.json 快照——结果就是 composer update 找不到新包、版本解析错、锁文件更新失败：

执行 composer clear-cache --dry-run 先看路径是否指向 ~/.composer/cache/（Linux/macOS）或 %APPDATA%\Composer\Cache\（Windows）
清完后运行 ls -la ~/.composer/cache/，应为空或只剩空子目录；若仍有内容，说明某些进程锁住了目录（如 PhpStorm 正在扫描）
极端情况可临时改缓存路径再清一次：composer config -g cache-dir /tmp/composer-cache-empty && composer clear-cache

验证是否真走官方源，别信命令没报错

执行完命令 + 清缓存后，必须做两件事才能确认生效：

composer config -g repo.packagist 应输出 Key "repo.packagist" does not exist 或空；composer diagnose 的 “Repo:” 行应变成 https://packagist.org/
运行 composer require monolog/monolog --no-install -vvv，盯住日志里 Downloading https:// 的 URL —— 正确应含 repo.packagist.org，不是 mirrors.aliyun.com 等镜像域名
检查项目级 composer.json 是否还有 "repositories" 字段（哪怕只是 "repositories": []），有就删掉整段；环境变量干扰也要查：env | grep COMPOSER_REPO（Linux/macOS）或 echo %COMPOSER_REPO_PACKAGIST%（Windows）

最易忽略的点：有些 Laravel 脚手架或私有模板生成的 composer.json 默认禁用了 packagist，这种配置是硬编码进模板里的，不改文件就永远绕不过去。