执行composer config -g --unset repos.packagist即可还原官方源，因删除该覆盖项后Composer自动回退至内置默认源https://packagist.org；需配合clear-cache并检查项目级repositories配置。
直接执行 composer config -g --unset repos.packagist 即可还原为官方源，不需要手动改配置文件或清缓存——但后续首次运行 composer install 或 composer update 时会明显变慢，这是正常现象。
为什么 unset 就能还原？
Composer 的全局配置中，repos.packagist 是一个覆盖默认行为的显式设置。一旦用 --unset 移除它，Composer 就会退回到内置的官方源地址 https://packagist.org，无需额外指定。
- 不是“恢复备份”，而是“删除覆盖项”，本质是让默认逻辑重新生效
- 该操作只影响全局配置（
-g），项目级配置（composer.json中的repositories）仍需单独处理 - 执行后可用
composer config -g repos.packagist验证是否已消失（返回空行即成功）
还原后 composer install 报错或卡住怎么办？
常见于项目之前长期使用国内镜像，composer.lock 文件里记录的包 URL 和哈希值仍指向镜像站。此时 Composer 会尝试从官方源拉取，但部分包可能因网络或重定向问题失败。
- 先运行
composer clear-cache，避免本地缓存残留镜像站元数据 - 再执行
composer update --lock，强制按当前源（即官方源）重新解析并更新composer.lock - 如果仍失败，可临时加
--ignore-platform-reqs跳过 PHP 版本等平台约束（仅调试用） - 不建议在 CI/CD 或生产环境跳过 lock 文件校验，否则可能引入不一致依赖
哪些场景必须还原为官方源？
不是所有情况都需要还原，但以下几类操作若未还原，大概率出问题：
- 发布开源包到 Packagist：上传前必须用官方源运行
composer validate和composer publish，否则依赖解析可能异常 - 调试包版本冲突：国内镜像偶尔同步延迟，某些新 tag 可能未及时收录，官方源才能看到最新状态
- 企业内网或安全审计要求：部分合规流程明确禁止使用第三方镜像源
- 提交
composer.json到公共仓库前：应确保repositories字段为空或仅含必要私有源，避免污染下游用户环境
最容易被忽略的是项目级 repositories 配置——即使全局已还原，composer.json 里还留着 "packagist": false 或自定义源，照样走不了官方源。检查时别只盯 config -g。
