验证镜像是否生效，必须执行composer config -g repo.packagist，输出必须是完整JSON对象{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}，空、null、仅URL或缺type均说明配置失败；-g不可省、键名须为单数repo.packagist、type值composer不可省、URL须HTTPS且末尾带/。
验证镜像是否真生效，别信“配完了”
执行 composer config -g repo.packagist，输出必须是完整 JSON 对象：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。如果返回空、null、只有 URL 字符串、或缺 type 字段，说明配置没写对——不是网络问题，是命令漏了关键要素。
-
-g不可省：缺了就只改当前项目，换目录或新开终端即失效 - 键名必须是单数
repo.packagist：写成repos.packagist、packagist.org或大小写混用（如Repo.Packagist）都会存进无效字段 -
composer是必需的type值：不是可选参数，也不是注释；漏掉它，Composer 直接忽略整条配置 - URL 必须以
https://开头且末尾带斜杠/：少一个会拼出/composerpackages.json，返回 404
清缓存 + 删 lock 文件，否则镜像白配
换了镜像仍卡在 Loading composer repositories，大概率不是镜像不可用，而是 Composer 还在读旧缓存或旧 composer.lock。它不会自动重走镜像流程。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先清缓存：
composer clear-cache - 删掉项目下的
vendor/和composer.lock（仅删vendor/不够，校验值还在 lock 里） - 再跑
composer install -vvv，看日志里出现的是mirrors.aliyun.com还是packagist.org -
composer update不会重新加载镜像配置，它只基于现有composer.lock解析依赖；要彻底重走镜像流程，必须删 lock 后重装
DNS 污染和 TLS 握手失败，得绕过系统层
Could not resolve host 或卡在 TLS handshake，不是 Composer 配错了，是系统 DNS 或 TLS 层被干扰。别急着改 composer.json。
- 先用
ping mirrors.aliyun.com和dig mirrors.aliyun.com @114.114.114.114确认是否 DNS 污染 - 企业防火墙启用 TLS 内容审查时，
curl -vI https://mirrors.aliyun.com/composer/packages.json会在 TLS 阶段中断，而浏览器能打开——此时需导出企业根证书为 PEM 格式，再执行composer config -g cafile /path/to/company-ca.crt - IPv6 支持不完整常导致 CI 环境隐性超时，加环境变量
COMPOSER_IPV4=1强制走 IPv4 - 临时验证是否 DNS 或代理问题：手机热点直连再跑一遍
composer install，成功则 100% 是原网络策略问题
CI/CD 和多用户环境容易踩的坑
容器每次重启丢配置、www-data 用户权限不对、项目级 repositories 覆盖全局设置——这些都让镜像在自动化流程中静默失效。
- CI 脚本开头必须显式设置
export COMPOSER_HOME=/tmp/composer，再跑composer config -g，否则配置写进 root 或 runner 用户家目录，后续步骤读不到 - 某些项目
composer.json里写了"packagist.org": false，会直接屏蔽全局镜像，得手动删掉或改成true - Windows 用户改完需重启终端，否则环境变量和配置缓存不会刷新
- 别在 CI 上跑
composer update：它会重新解析依赖树，耗时远高于install，且不强制走新镜像
composer.lock 里的哈希值与镜像同步后的新包不匹配——删 vendor 不删 lock，等于只擦了表面，底层校验链还是断的。 
