镜像未生效的三大主因是配置键名错误（如repos.packagist）、url缺末尾斜杠、命令遗漏composer类型参数；需验证config输出、-vvv日志域名及composer.lock锁址。
composer install 卡在 Downloading 或 Loading composer repositories，不是网络差，是镜像根本没生效——配错 repo.packagist、URL 少斜杠、用错用户权限，三者任一都会让加速失效。
为什么 composer config -g repo.packagist 常常白配
这条命令看似简单，但 Composer 会静默忽略几乎所有常见错误，且不报错：
-
repo.packagist写成repos.packagist（多一个 s）：配置写进无效字段，composer config -g repo.packagist输出为空 - URL 缺末尾
/：例如https://mirrors.aliyun.com/composer→ 请求packages.json时拼成/composerpackages.json，404 后 fallback 到官方源 - 没加
composer类型参数：命令写成composer config -g repo.packagist https://...，缺了composer，Composer 2.0+ 直接忽略 - HTTPS 被拦截或 DNS 解析失败：比如企业防火墙屏蔽
mirrors.前缀，此时换清华源（https://mirrors.tuna.tsinghua.edu.cn/composer/）可能通
项目级配置比全局更稳，但必须写对结构
全局配置在 CI、宝塔、多用户环境里极易失效（root 配的，www 用户跑不了），推荐直接改 composer.json：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保
repositories是对象（不是数组），否则composer config repo.packagist命令会报错或覆盖整个字段 - 手动添加时，key 必须是
"packagist"（无.org），type 为"composer"，URL 以/结尾 - 必须在根节点加
"packagist.org": false，否则 Composer 仍会 fallback 到官方源 - 已有私有源？别删，把 packagist 条目作为数组第一项追加，顺序不影响解析，但能避免误删
composer install 还慢？先看日志里真正请求的是谁
执行 composer install -vvv | grep "Loading composer repositories" 或 grep "Downloading"，关键看域名：
- 出现
mirrors.aliyun.com或mirrors.tuna.tsinghua.edu.cn→ 镜像已生效 - 出现
packagist.org或api.github.com→ 镜像未生效，或composer.lock里锁的是旧 dist URL - 出现
codeload.github.com→ zip 包还在直连 GitHub，需配合ghproxy.com或清理composer.lock后重装 - 卡在
Resolving dependencies？和镜像完全无关，检查 PHP 版本约束、dev 包数量、platform配置
私有包不能套用公共镜像，否则元数据直接 404
阿里云、清华等镜像只缓存 packagist.org 公开包，对 internal/auth-sdk 这类私有包无感知：
- 强行把私有源
url设为镜像地址，composer require internal/auth-sdk会报Could not find package - 私有包提速靠的是提前注入认证：
composer config http-basic.repo.example.com username password，凭据存在auth.json且加.gitignore - Git 私有仓库优先用
"type": "vcs"，比"type": "composer"更轻量，不走元数据代理 - 混合源场景下，禁用默认源应写
"packagist": false（顶层键，无.org），不是"packagist.org": false
composer config -g repo.packagist 输出是否含完整 JSON、composer install -vvv 日志里是否命中镜像域名、composer.lock 是否被旧 dist URL 锁死——这三处，漏查任何一处，换十次镜像都没用。
