Composer config –unset repos.packagist：如何恢复Composer官方源？

删掉 repos.packagist 不会自动恢复官方源，因官方源靠隐式 fallback 机制而非该键启用；若此前显式禁用（如 “packagist”: false），删除键值后仍不启用，需手动添加 type: “composer” 源才能恢复。

执行 composer config --unset repos.packagist 后，Composer 会彻底删除 repos.packagist 这个自定义源配置，但 ** 不会自动恢复官方 Packagist 源 **——因为官方源不是靠这个键名启用的，而是默认内置、且由 packagist.org 的隐式 fallback 机制提供。一旦你删了它，又没手动加回，composer install 或 composer require 就可能报错找不到包。

为什么 删掉 repos.packagist 会导致无法拉取官方包？

这个配置项只在你 ** 显式覆盖默认源 **（比如设了 "repos": {"packagist": false} 或指向私有镜像）时才有意义。一旦用 --unset 清掉它，Composer 不会“自动补上默认值”，而是继续按当前 repos 结构解析——如果整个 repos 被清空或只剩无效项，它就不再尝试访问 packagist.org。

• Composer 8+ 默认启用 packagist.org 作为隐式全局源，但前提是 repos 配置不显式禁用它
• 如果你之前设过 "packagist": false，删掉键只是移除了那个 false 值，但没恢复“启用”状态
• composer diagnose 会提示 You have configured a custom repository, but no packagist.org repository was found.

如何正确恢复官方 Packagist 源？

最稳妥的方式是 ** 显式声明启用官方源 **，而不是依赖隐式行为。推荐以下任一操作：

• 运行 composer config --global repos.packagist composer https://packagist.org（全局生效）
• 运行 composer config repos.packagist composer https://packagist.org（仅当前项目）
• 手动编辑 composer.json，确保 repositories 区域包含：

{"repositories": [         {             "type": "composer",             "url": "https://packagist.org"}     ] }

注意："packagist": false 和 "packagist.org": false 是两种常见误配，前者已弃用，后者在 Composer 2.2+ 才支持；恢复时统一用上面的 type: "composer" 方式最兼容。

检查是否真的恢复成功？

别只看 composer config --list 里有没有 repos.packagist，要实测源是否可用：

• 运行 composer show -p | head -5，应能列出真实包（如 composer/composer），而非空输出或报错
• 运行 composer clear-cache && composer require monolog/monolog:3.0.0 --dry-run，确认不报 Could not find package
• 查看 composer diagnose 输出，最后一行应为 OK，且没有关于 missing packagist 的警告

如果仍失败，大概率是缓存残留或项目级 composer.json 里还留着 "packagist": false —— 直接搜文件删掉这行再试。