Composer镜像配置不可备份地址本身，需备份~/.composer/config.json（全局）和项目composer.json中repositories声明及"packagist.org": false开关逻辑，三者缺一不可。
Composer 镜像地址本身不能“备份”，它只是全局或项目级的一组配置值；真正要防丢失的，是这些配置所在的文件及其上下文逻辑。
composer config -g repos.packagist.org 写了却没生效？
这是最常被误判为“配置丢失”的现象——其实不是丢了，而是根本没写对位置或版本不兼容。Composer 2.2+ 把官方源抽象成名为 packagist.org 的仓库，对应配置键必须是 repos.packagist.org，不是旧版的 repo.packagist。
- 运行
composer config -g repos.packagist.org查看是否已有值；为空说明你之前设的是错的键名 - 设新值用
composer config -g repos.packagist.org composer https://mirrors.aliyun.com/composer/（注意末尾/） - 设完立刻验证：新建空目录，执行
composer init -n && composer require monolog/monolog --no-install，观察终端里实际请求的域名 - 如果看到
packagist.org或报Could not resolve host: mirrors.aliyun.com，说明网络策略或 hosts 拦截了请求，不是配置问题
全局镜像配置存在哪儿？怎么安全备份？
所有 composer config -g 写入的内容，最终都落在 ~/.composer/config.json 这个文件里。它不是“导出项”，而是真实配置源——直接复制它就是最可靠的备份方式。
- 先确认路径：
composer config --global --list第一行显示的 “Global configuration file” 路径（如/home/user/.composer/config.json） - 备份命令：
cp ~/.composer/config.json ~/.composer/config.json.backup-$(date +%Y%m%d) - 别手动编辑或重建该文件：JSON 格式极敏感，少个逗号或引号不闭合，后续所有
composer命令都会报file_get_contents(): Failed to open stream - 如果用了
COMPOSER_HOME环境变量，备份前务必echo $COMPOSER_HOME确认指向位置，否则可能备份错文件
项目级镜像配置为什么比全局更值得备份？
因为它是 Git 可追踪、团队可一致的显式声明，不受开发者本地全局设置干扰。一旦项目根目录下 composer.json 的 repositories 字段被删或改错，CI/CD 就可能直连 packagist.org 导致超时或失败。
- 正确写法示例（写入项目
composer.json）：{ "repositories": { "packagist.org": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" } }, "packagist.org": false } - 这个
"packagist.org": false很关键：它禁用默认源，强制走你声明的镜像，避免 fallback 到慢速或不可靠的上游 - 必须把整个
composer.json提交到 Git；仅靠全局配置无法保证协作环境一致性 - 不要在项目里混用
composer config repositories.xxx和手动编辑composer.json，容易覆盖冲突
真正容易被忽略的是：镜像地址只是表象，背后起作用的是 config.json 文件的完整结构 + composer.json 中 repositories 的显式声明 + "packagist.org": false 的开关逻辑。三者缺一，都可能导致你以为“备好了”，结果恢复时发现依赖拉不下来。
