安全备份Composer环境变量配置需执行三步：运行composer config -g --list导出全局JSON配置，用echo $COMPOSER_REPO_PACKAGIST捕获镜像变量值，检查$COMPOSER_CACHE_DIR是否设置并记录；三者合并保存为带日期的文本文件。
如何安全备份当前Composer环境变量配置
直接改环境变量前不备份，等于裸奔。最可靠的方式是导出当前生效的完整配置快照，而不是只记下几个变量名。
执行这三步就能拿到真实、可还原的环境状态：
- 运行
composer config -g --list导出全局 JSON 配置（含repo.packagist、cache-dir等） - 用
echo $COMPOSER_REPO_PACKAGIST（Linux/macOS）或echo %COMPOSER_REPO_PACKAGIST%（Windows）捕获镜像环境变量值 - 检查
COMPOSER_CACHE_DIR是否已设置：echo $COMPOSER_CACHE_DIR或echo %COMPOSER_CACHE_DIR%；它优先级最高，但不会出现在config --list里
把这三段输出保存为 composer-env-backup-20260905.txt 这类带日期的文件，比截图更可靠——文本可搜索、可 diff、可 git track。
还原时为什么不能只改 config 而要清缓存
还原环境变量后仍走旧镜像？大概率是缓存没清。Composer 的 clear-cache 不是“清理下载包”，而是清掉 ~/.composer/cache/repo/ 下所有元数据快照，包括 packages.json 缓存、dist 包哈希、provider 列表等。
不清缓存的后果很具体：
-
composer install仍从阿里云 URL 下载 dist 包（因为缓存里还存着旧的packages.json） -
composer show显示的包信息仍是镜像源结构（比如 provider 合并后的扁平数组），和官方源不一致 - 哈希校验失败（
hash verification failed）反复出现，因为锁文件里记录的 sha256 和缓存中旧镜像返回的包不匹配
所以还原流程必须是：改配置 → 清缓存 → 验证请求域名。缺一不可。
COMPOSER_CACHE_DIR 被忽略的典型场景
你明明设了 COMPOSER_CACHE_DIR，但 composer global show -v 显示的还是默认路径？问题往往出在路径创建和解析上。
常见失效点：
- 目录没手动创建：Composer 不会自动建目录，
mkdir -p "$COMPOSER_CACHE_DIR"必须执行 - 路径含中文或空格但没加英文双引号：PowerShell 中
$env:COMPOSER_CACHE_DIR="C:\my cache"会失败，得写成$env:COMPOSER_CACHE_DIR="C:\my cache"（注意引号） - 在 Git Bash 里设了系统环境变量，但它不读 Windows PATH，得单独在
~/.bashrc里加export COMPOSER_CACHE_DIR="$APPDATA/Composer/cache" - CI/CD 中用了相对路径挂载缓存（如
./cache），Docker 容器内路径解析失败，必须用绝对路径（/tmp/composer-cache-2.6）
验证是否真正生效，唯一标准是 composer global show -v | grep "Cache directory" 输出和你设置的路径完全一致。
项目级 repositories 覆盖全局配置的静默陷阱
你以为全局切回了 https://packagist.org，结果 composer update 还是从腾讯云拉包？十有八九是项目 composer.json 里残留了 "repositories" 字段。
这个字段哪怕写成空数组也会屏蔽全局设置：
"repositories": []
或者更隐蔽地写成：
"repositories": [
{
"type": "composer",
"url": ""
}
]
这类配置不会报错，但会让 Composer 放弃 fallback 到官方源，直接卡在 “Loading composer repositories…”。解决方法只有一个：打开 composer.json，删掉整个 "repositories": ... 块，不要留空、不要注释、不要改值——删键才是重置。
复杂点在于，有些 Laravel 模板或私有脚手架会硬编码禁用 packagist，这种配置藏在 vendor 提交的 composer.json 里，不手动翻源码根本看不到。
