执行 composer config -g repo.packagist composer https://packagist.org 可强制覆盖全局配置为官方源，再清缓存、删项目级 repositories 和环境变量，才能真正恢复；仅删除旧配置无法触发自动回退，因 composer 2.2+ 不再自动补全缺失的 repo.packagist 字段。
直接执行 composer config -g repo.packagist composer https://packagist.org 覆盖全局配置，并清缓存、删项目级 repositories，才能真正回归官方源——删配置不如强制覆盖，尤其当旧镜像字段已损坏或被误删时。
为什么删掉镜像配置后 Composer 仍报“no valid repository found”
这不是网络或权限问题，而是 Composer 在找不到 repo.packagist 字段时不会自动 fallback，尤其当该字段曾被手动删空、写错名（如 repos.packagist）、或值为 {} / null 时，它会直接放弃加载任何源。
-
composer config -g --unset repos.packagist在新版中无效：字段名应为repo.packagist（单数），多一个s就静默失败 - 删掉字段后不等于“恢复默认”，Composer 2.2+ 不再自动补全，必须显式写入合法值
- 若
composer config -g repo.packagist输出为空、null或{}，说明当前无有效源定义，命令已失效 - 项目级
repositories字段存在（哪怕只写"repositories": []）会完全屏蔽全局设置，导致删全局毫无意义
如何用一条命令安全恢复官方源（推荐做法）
跳过所有“删字段→等 fallback”的不可靠路径，直接覆盖为明确、合法的官方源：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 - 必须带
-g，否则只改当前项目；必须写composer作为 type 值，不能省略 - 验证是否生效：
composer config -g repo.packagist应输出完整 JSON：{"type": "composer", "url": "https://packagist.org"} - 如果输出仍是空或报错，说明命令未执行成功——检查是否在 root 用户下运行，而当前 PHP 进程以 www-data 等低权限用户启动（常见于 Docker 或宝塔）
必须同步清理的三个干扰层
只动全局配置，90% 场景下都会失败。Composer 查源顺序是：环境变量 > 项目级 composer.json > 全局 config.json，任一层残留都会覆盖你刚设的官方源。
- 删项目级
repositories：composer config --unset repositories（进项目根目录后执行）；若失败，手动打开composer.json，删掉整个"repositories": {...}或"repositories": [...]块，注意校验逗号和括号 - 清环境变量：
unset COMPOSER_REPO_PACKAGIST（Linux/macOS）或set COMPOSER_REPO_PACKAGIST=（Windows） - 清缓存：
composer clear-cache—— 否则 Composer 仍会从~/.composer/cache/repo/里读旧镜像的packages.json，表现就是composer show找不到包、install卡在 “Loading repositories”
验证是否真走官方源（别信配置输出）
配置命令成功 ≠ 实际请求走对地方。必须看 HTTP 请求日志：
- 运行：
composer require monolog/monolog --no-install -vvv 2>&1 | grep "GET https"（Linux/macOS） - 观察输出中是否出现
GET https://repo.packagist.org/packages.json—— 注意是repo.packagist.org，不是packagist.org - 如果仍看到
mirrors.aliyun.com或其他镜像域名，说明某处还有残留：grep -n '"repositories"' composer.json再查一遍；或 CI 构建脚本里硬编码了镜像地址 - 特别注意：某些 IDE 插件（如 PHPStorm 的 Composer 支持）会在你不知情时往
~/.composer/config.json写配置，定期运行composer config --list --global | grep -i mirror扫描异常项
最易被忽略的是缓存目录里的元数据快照——它不随配置更改自动更新，也不被 clear-cache 完全覆盖（尤其旧版 Composer），必要时可手动删掉 ~/.composer/cache/repo/https---repo-packagist-org 目录后再试。
