Composer镜像元数据备份需同时保留全局配置文件、项目composer.json及~/.composer/cache目录三者，缺一不可；仅备份镜像URL无效，因真正决定依赖解析的是缓存中的packages.json等元数据文件。
中文镜像（如阿里云、腾讯云）只是元数据源的代理，备份对象不是“镜像地址”，而是镜像配置本身 + 元数据缓存内容。直接备份 ~/.composer/cache/ 目录比试图导出“镜像包列表”更有效、更可靠。
为什么不能只备份镜像 URL？
镜像地址本身不携带任何元数据——它只是一个 HTTP 端点。Composer 从镜像拉取的 packages.json、provider-*.json 等文件才真正构成可离线使用的元数据快照。这些文件全存在缓存目录里，且按域名和哈希组织。删掉缓存再换镜像，composer install 就会卡在“Resolving packages…”；没清缓存却换了镜像，反而可能混用新旧元数据，导致版本解析错乱。
- 镜像配置（如
repos.packagist.org）只是告诉 Composer “去哪请求”，不是“请求到了什么” - 真正决定依赖能否安装成功的，是缓存中已下载的
packages.json和 provider 文件 -
composer config -g repos.packagist.org https://mirrors.aliyun.com/composer/这条命令本身不生成任何元数据，只改配置
如何安全备份镜像元数据缓存？
缓存目录就是元数据的物理载体。备份它，等于备份了当前镜像下所有已访问过的包信息。关键在于路径确认和完整性校验：
- 先运行
composer config --global cache-dir确认真实路径（常见为~/.composer/cache/，但受COMPOSER_HOME影响） - 执行
tar -czf composer-cache-backup-$(date +%Y%m%d).tar.gz -C ~/.composer cache/（注意-C指定父目录，避免路径嵌套） - 验证备份有效性：解压后检查是否存在
cache/repo/https---mirrors-aliyun-com-composer/子目录及其中的packages.json - 不要只备份
cache/repo/下某一层——Provider 文件分散在多个子目录，缺一不可
备份后如何在无网环境还原并使用？
单纯解压缓存到目标机器的 ~/.composer/cache/ 并不够。必须让 Composer 明确知道“该用哪个镜像”，否则它仍会尝试连接原始 packagist.org：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先恢复全局配置：
cp config.json.backup ~/.composer/config.json（确保repos.packagist.org值与原镜像一致） - 再清空并替换缓存：
rm -rf ~/.composer/cache/ && tar -xzf composer-cache-backup-20260707.tar.gz -C ~/.composer - 强制刷新本地元数据索引：
composer clear-cache && composer diagnose -v—— 此时应看到 “Checking composer version: OK” 且无网络请求日志 - 验证是否生效：
composer require monolog/monolog --no-install -vvv | grep "Downloading"，输出 URL 应指向你的镜像域名，而非 packagist.org
别忽略镜像配置的上下文依赖
镜像配置是否生效，取决于三层优先级：环境变量 > 当前项目 composer.json 中的 repositories > 全局配置。即使你备份了 ~/.composer/config.json，如果项目根目录下 composer.json 里写了：
"repositories": [
{
"type": "composer",
"url": "https://packagist.org"
}
]
那全局镜像配置就完全被绕过。所以完整备份必须包含：
- 全局配置文件：
~/.composer/config.json - 每个项目的
composer.json（尤其检查repositories和"packagist.org": false设置） - 实际缓存内容（
~/.composer/cache/）
三者缺一，元数据备份就只是半成品——看起来有数据，但 Composer 在还原时根本不会加载它。
