全局镜像配置仅作用于Packagist.org公开包，遇项目级repositories字段即彻底失效；URL须带末尾斜杠，缓存未清或路径错误会导致404或流量未走镜像。
composer config -g repo.packagist 的生效范围和失效条件
它只影响 Packagist.org 上公开注册的包（如 monolog/monolog），对私有源、path 类型仓库、VCS 仓库完全无感。一旦项目级 composer.json 中出现 repositories 字段，全局镜像配置立刻被绕过——不是“优先级低”，而是彻底不读。
常见失效场景：
-
composer.json里写了"repositories": [{"type": "composer", "url": "https://packagist.org"}]→ Composer 直连官方源，镜像形同虚设 - 误写成
composer config -g repos.packagist（多一个s）→ 静默失败，composer config -g repo.packagist输出为空 - 项目中存在
"packagist.org": false→ 不仅关掉官方源，还顺手屏蔽了所有镜像行为，composer install会直接报Could not find package
镜像 URL 格式错误导致请求 404 的真实原因
Composer 拼接元数据路径时，会把镜像 URL 和固定后缀 /packages.json 直接拼接。如果 URL 缺少末尾斜杠，比如 https://mirrors.aliyun.com/composer，最终请求变成 https://mirrors.aliyun.com/composer/packages.json → 404。
验证方法：
- 运行
composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 手动
curl -I https://mirrors.aliyun.com/composer/packages.json，响应头必须含Content-Type: application/json - 执行
composer install -vvv | grep -i "mirrors.aliyun"，没输出说明流量根本没走镜像
缓存污染让镜像配置“看起来没生效”
Composer 缓存的是元数据文件（packages.json、provider-*.json 等），不是 ZIP 包本身。即使你刚配好镜像，只要缓存里还存着从 packagist.org 下载的老元数据，后续 install 就仍会尝试去海外拉取，超时或失败后才 fallback 到镜像——这不是镜像慢，是缓存没清干净。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须同步清理：
-
composer clear-cache（清空files/和部分repo/） - 手动删掉
~/.composer/cache/repo/https---packagist.org/（Linux/macOS）或%APPDATA%\Composer\Cache\repo\https---packagist.org\（Windows） - 若用 Docker 或 CI，还要确认
COMPOSER_CACHE_DIR环境变量没覆盖默认路径，且 UID/GID 有写权限
私有包更新检查为何不走镜像
composer outdated --all 对私有包无效，不是镜像问题，是协议限制：Composer 默认只查 Packagist 元数据，不会主动轮询你内网的 packages.json。它不支持“动态发现”私有源版本，只能靠你人工维护索引。
正确做法：
- 确保私有源（Satis/Nexus/Artifactory）提供可访问的
packages.json，且其中versions字段包含完整语义化版本列表 - CI 构建后触发
satis build或等价命令，强制重建索引 - 检查
repositories数组顺序：私有源放后面，避免意外覆盖开源包匹配 - 别指望
composer audit能识别私有包的abandoned状态——它只读 Packagist 元数据
镜像配置的生命周期，本质是“配置 → 清缓存 → 验证流量 → 排除项目级覆盖”。漏掉任意一环，都会让你以为镜像失效，实际只是状态没刷新。
