最可靠恢复方式是执行 composer config -g repo.packagist composer https://packagist.org，它明确覆盖而非删除配置，绕过 fallback 逻辑，在 Composer 2.0+ 全版本稳定生效。
直接执行
是最可靠、兼容性最好的恢复方式，不是删配置，而是明确覆盖。它绕过 Composer 内部所有 fallback 判断逻辑，在 2.0+ 全版本（包括 2.2–2.4 这些易出错的旧小版本）都能稳定生效。
为什么
有时会失败
这个命令看似简洁，但本质只是删除 JSON 字段，不触发“还原默认值”行为。实际问题常出在：
字段名写错：必须是
（复数），写成
（单数）不会报错，但无效
旧版 Composer（如 2.2–2.4）在删掉
后，fallback 逻辑可能崩溃，报
或卡住不动
删对了字段，但项目级
里还有
块，它优先级更高，全局删了也白删
环境变量
仍存在，会彻底盖掉所有配置
怎么确认当前真正走的是官方源
别信命令没报错就成功了——必须验证两件事：配置已生效、网络请求地址正确。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
查当前实际生效的源：
（不带
），输出应含
，而不是
等镜像域名
看真实请求地址：
，滚动日志里找
开头的行，URL 必须是
检查缓存是否清空：
（Linux/macOS）或
（Windows），目录应为空或只剩空子目录
三层配置覆盖关系必须理清
Composer 查源顺序是固定且严格的：环境变量 > 项目级配置 > 全局配置。哪怕你全局设对了，只要其中一层“盖住”了，就一定不生效。
查项目级是否自定义：
（Linux/macOS），或手动打开
搜索
临时覆盖项目级设置：进项目目录后运行
查环境变量干扰：
（Linux/macOS）或
（Windows），有就
或对应清除
最常被忽略的一点：缓存不清，换源等于白换。哪怕配置全对、URL 正确，
仍可能拉错包、锁文件错乱、甚至报
—— 因为它还在读缓存里的旧镜像元数据快照。
composer config -g repo.packagist composer https://packagist.orgcomposer config -g --unset repos.packagistrepos.packagistrepo.packagistrepos.packagistCould not parse version constraintcomposer.json"repositories"COMPOSER_REPO_PACKAGISTcomposer config repo.packagist-ghttps://repo.packagist.orgmirrors.aliyun.comcomposer require monolog/monolog --no-install -vvvDownloading https://https://repo.packagist.orgls -la ~/.composer/cache/dir %APPDATA%\Composer\Cache\grep -A 5 '"repositories"' composer.jsoncomposer.jsonrepositoriescomposer config repo.packagist composer https://packagist.orgenv | grep COMPOSER_REPOecho %COMPOSER_REPO_PACKAGIST%unset COMPOSER_REPO_PACKAGISTcomposer updatePackage not found