正确配置需执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，确保键名、type值和url末尾斜杠三要素齐全，配后必须clear-cache并用composer install -vvv验证日志中是否出现mirrors.aliyun.com。
国内用 Composer 不配镜像源，根本装不完——不是慢，是卡死在 TLS 握手、DNS 解析或 403 错误上。 阿里云和腾讯云镜像都能用，但配置错一个字符、漏清缓存、或被项目级配置覆盖，就等于没配。
composer config -g repo.packagist 命令必须写对
这是全局换源最核心的一条命令，拼错就白干。常见错误包括：
-
repo.packagist写成repos.packagist（多了一个s），Composer 会直接忽略该配置 - URL 末尾漏掉斜杠
/，部分 Composer 版本会拼接出https://mirrors.aliyun.com/composer/packages.json变成 404 - 用了已停用的地址，比如
https://packagist.phpcomposer.com（2025 年底下线）或https://packagist.laravel-china.org（同样失效）
正确写法只有一条：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意：中间的 composer 是 type 字段值，不能省；URL 必须带协议、域名、路径、结尾斜杠。
配完必须执行 composer clear-cache
旧缓存里存着 packagist.org 的元数据，哪怕源已改，Composer 仍会优先读缓存，然后卡在 DNS 或 TLS 层——看起来像“不动”，其实是反复重试失败。
验证是否真清了：
- 运行
composer clear-cache，看到Clearing cache (cache-dir): ...和Clearing cache (cache-vcs): ...两行才算成功 - 再跑
composer config -g repo.packagist，输出必须是完整 URL，如https://mirrors.aliyun.com/composer/，不是空、不是 JSON 对象、更不是旧地址
如果输出仍是 {"type":"composer","url":"https://packagist.org"}，说明配置根本没生效，别急着装包，先回退检查命令。
composer install -vvv 日志里必须出现 mirrors.aliyun.com
这是唯一能确认镜像真正起效的方式。运行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer install -vvv
滚动到最后几行，找类似这样的日志：
Reading packages.json from cache at /home/user/.composer/cache/repo/https---mirrors-aliyun-com-composer/packages.json
如果看到的是 https---packagist-org 或 https---packagist-laravel-china-org，说明 fallback 了，当前命令仍在走海外源。
此时可临时绕过所有自定义配置验证：
-
composer install --no-plugins --repository=https://packagist.org：强制走官方源，看是否变慢（用来反向确认本地镜像是否真快） -
composer install -vvv --repository-url=https://mirrors.tuna.tsinghua.edu.cn/composer/：单次切换清华源，快速测试镜像可用性
注意：--repository 参数只对当次命令有效，关掉终端就失效，不能替代全局配置。
项目级 repositories 会覆盖全局配置
如果你进过项目目录并执行过不带 -g 的 composer config repo.packagist ...，那 composer.json 里就多了 "repositories" 字段，它会完全屏蔽全局设置。
检查方式：
-
composer config --list查看实际生效的所有配置（含项目级 + 全局级） -
composer config --list --global只看全局配置，对比两者差异
如果项目里已有 "repositories"，又想保留私有源，不要用 composer config 覆盖，应手动编辑 composer.json，把 packagist 源合并进去，结构类似：
"repositories": {
"packagist": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" },
"my-private": { "type": "composer", "url": "https://private.example.com" }
}
否则，composer install 会先尝试连私有源，超时后才 fallback 到 packagist，整个过程可能拖慢数分钟。
