Composer全局镜像不生效的主因是字段名错误（应为repos.packagist而非repo.packagist）、项目级repositories配置屏蔽全局设置、环境变量覆盖、元数据缓存未刷新、IPv6或代理干扰；需用-vvv验证请求URL并逐层排查。
composer config -g 配置后不生效的常见原因
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后，composer install 仍连 packagist.org，大概率不是命令没跑，而是配置被覆盖或写错字段名。
- Composer 2.x 实际读取的是
repos.packagist（复数、带s），但很多人误用repo.packagist（单数）——两者互不干扰，删错字段等于白操作 - 项目级
composer.json中若存在"repositories"字段（哪怕值是{"packagist.org": false}），就会**完全屏蔽全局镜像配置** - 环境变量优先级更高：
COMPOSER_REPO_PACKAGIST或COMPOSER_REPOSITORIES若已设置，会直接覆盖所有配置
验证镜像是否真正启用
别只信命令输出，要看 Composer 运行时实际请求的 URL。最可靠的方式是加 -vvv 观察下载行为：
- 运行
composer require monolog/monolog --no-install -vvv - 盯住终端最后几行，找类似
Downloading https://mirrors.aliyun.com/composer/packages.json的日志 - 如果看到的是
https://repo.packagist.org或其他非镜像域名，说明某层配置或缓存仍有残留
同时验证配置项：运行 composer config -g repos.packagist，应输出完整 JSON 对象；若报 Key "repos.packagist" does not exist，说明字段名或写入方式有误。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
缓存不清理 = 配置白设
Composer 元数据缓存（packages.json 快照）默认 15 分钟不过期，即使你改了镜像源，它仍可能从旧缓存里拉数据，导致“更新失败”“找不到新包”“锁文件解析错乱”。
- ≥ 2.5 版本：用
composer update --refresh强制丢弃所有元数据缓存 - ≤ 2.4 版本：手动删对应路径，例如
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer -
composer clear-cache不够——它只清 ZIP 和 provider 缓存，不碰元数据
代理与 IPv6 干扰常被忽略
换镜像后仍卡在 * Trying 240e::... 或 TLS 握手阶段，很可能是 IPv6 路由异常或代理劫持，而非镜像本身问题。
- 强制走 IPv4：
COMPOSER_IPV4=1 composer install - 检查是否残留代理：
composer config -g http-proxy，若存在且当前不需要，用composer config -g --unset http-proxy清除 - 公司/校园网常见 HTTPS 代理劫持，会导致
curl error 35或静默超时，此时需联系网络管理员，或临时改用 DNS（如114.114.114.114）
镜像配置只是入口，真正生效要过三层校验：环境变量 → 项目 composer.json → 全局配置；任何一层出错，都会让切换失效，而且不容易一眼看出。
