composer镜像配置失效主因是命令格式错误、缓存未清及项目级repositories字段覆盖全局设置；必须确保repo.packagist键名正确、url末尾带/、type显式为composer，并删除vendor与composer.lock后运行install。
Composer 镜像源本身不提供同步容灾或备份能力，所有“容灾”“降级”“切换”都是客户端侧的临时应对措施，必须手动清理缓存、探测可用性、覆盖配置，且项目级 repositories 会彻底屏蔽全局设置。
为什么 composer config -g repo.packagist 切不了源
这个命令只写一个值，反复执行是覆盖不是追加。一旦项目根目录存在 composer.json 中的 repositories 字段（哪怕内容为空数组 []），Composer 就完全忽略全局配置，直连 packagist.org 或按数组第一个源发起请求。
- 验证是否被覆盖：
composer install -vvv | head -n 5，看第一行下载地址是不是你设的镜像域名 - 临时解除覆盖：
composer config --unset repositories（仅当前项目） - 长期保留私有源时，必须在
composer.json的repositories数组里显式写入镜像 URL，并在顶层加"packagist.org": false - 漏掉
"packagist.org": false，Composer 仍会偷偷访问官方源，导致私有包被跳过
缓存污染比连接失败更危险
当镜像站返回 502、503 或超时，Composer 默认把错误响应体（比如 HTML 错误页）直接写进 ~/.composer/cache/repo/https---mirrors-aliyun-com-composer/packages.json。下次 composer update 根本不发网络请求，直接读这个坏文件——表现为“卡死无日志”，比超时还难排查。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer clear-cache只清files/目录（ZIP 包），不碰repo/下的元数据缓存 - 必须手动清理：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer - CI 环境建议强制跳过缓存：
composer install --no-cache -v - Windows 用户路径在
%LOCALAPPDATA%\Composer\cache\repo\，需用robocopy备份，不能拖拽
如何真正实现“多镜像备用”
Composer 不支持自动 fallback，所谓“备用”只能靠外部脚本完成三步闭环：探活 → 切换 → 清缓存。项目 repositories 数组也不是负载均衡，它只对明确返回 404 的源才试下一个；超时、502、DNS 失败都会中断，不会往下走。
- 探活必须用
curl -s -f -m 10 $url/packages.json > /dev/null，只认200，502/503/timeout 都算不可用 - 切换后必须清对应 repo 缓存目录，否则新配置不生效
- 项目级配置优先级永远高于全局，所以容灾脚本应优先写入项目
composer.json，而非依赖-g - 末尾缺
/（如https://mirrors.aliyun.com/composer）会导致路径拼接错误，变成/composerpackages.json→404→ 静默 fallback 到官方源
备份什么、怎么备份才有效
备份不是复制文件夹，而是确认“当前生效的配置在哪、长什么样、是否完整”。composer config -g repo.packagist 是唯一可信检查方式，输出必须是合法 JSON 对象（如 {"type":"composer","url":"https://mirrors.tuna.tsinghua.edu.cn/composer/"}），字符串或空值都说明配置已损坏或格式错误。
- 先运行
composer config -g --list查实际路径，新版 Composer 默认在~/.config/composer/config.json，旧版在~/.composer/config.json - 必须递归备份整个目录：
cp -r ~/.config/composer ~/backup/composer-global-$(date +%Y%m%d) - 单独备份
config.json不够：auth.json（含 GitHub token）、keys/（GPG 密钥）也必须一起打包，否则composer global install会失败 - 项目级
repositories配置需额外备份对应项目的composer.json，不能只靠全局
最常被忽略的是：镜像 URL 末尾斜杠、"packagist.org": false 的位置、以及 repo/ 缓存目录的手动清理 —— 这三处出错，所有容灾逻辑都会静默失效，表现却像“镜像又挂了”。
