Composer换源失败主因是命令错误或配置未生效：必须用composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏type、拼错键名、URL缺尾斜杠均导致静默失效；还需清缓存、删lock文件、注意用户权限及xdebug影响。
composer config -g repo.packagist 命令写错就白配
90% 的“换源没效果”不是网络问题，是命令本身静默失败。必须同时满足三件事：repo.packagist（不能多写 s）、composer 作为 type 值、URL 末尾带斜杠且为 HTTPS。
正确写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 漏掉
composer这个 type 参数 → fallback 到官方源，不报错 - 写成
repos.packagist或packagist.org→ 配置被忽略，composer config -g repo.packagist输出null - URL 少了末尾
/→ 拼出https://mirrors.aliyun.com/composerpackages.json，404
验证是否生效：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象或至少含 https://mirrors.aliyun.com/composer/ 字符串。
composer install 卡在 Downloading？镜像只管元数据，不管 zip 包
配完阿里云或清华源，composer install 仍卡在 Downloading https://codeload.github.com/...，说明 zip 包还在直连 GitHub —— 镜像源不托管 dist 文件，只提供元数据。
真正起效的组合方案：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 全局换源后，必须执行
composer clear-cache，否则缓存里还存着旧的dist.url - 删掉项目里的
composer.lock再跑composer install，否则 lock 文件里记录的仍是github.com地址 - 加
--prefer-dist强制走 ZIP 下载（跳过 git clone），避免触发 SSH 认证或代理问题 - 临时验证镜像是否真生效：用
composer install -vvv --repository=https://mirrors.tuna.tsinghua.edu.cn/composer/，看日志里Reading packages.json from cache at .../https---mirrors-tuna-tsinghua-edu-cn-composer/
Resolving dependencies 卡住？换源完全无效
这个阶段不发任何 HTTP 请求，纯本地 PHP 计算。日志里出现 “Resolving dependencies” 超过 10 秒，和镜像无关，得查环境与约束。
常见真实瓶颈：
-
php.ini里memory_limit太小（如 128M），设COMPOSER_MEMORY_LIMIT=-1临时绕过 - 启用了
xdebug（php -v看输出），会让求解器慢 5–10 倍，用php -d xdebug.mode=off $(which composer) update临时禁用 -
composer.json里写了模糊版本，比如"*"、"dev-main"或"^1.0 || ^2.0"，导致组合爆炸 - 项目级
repositories数组覆盖了全局配置，但里面混了私有源又没写全，Composer 回退到 packagist.org 查找失败再重试
CI/宝塔/计划任务里镜像失效？用户权限搞错了
宝塔面板、GitLab CI、crontab 默认以 www 或 runner 用户运行，而 composer config -g 写的是当前登录用户的配置（如 /root/.composer/config.json），它们根本读不到。
解决办法分场景：
- 宝塔计划任务：进终端运行
whoami确认用户，再用sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 流水线：在 job 开头加
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，并确保~/.composer/cache被缓存 - 团队协作项目：直接在项目根目录运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），它会写进composer.json的repositories字段，Git 可追踪
真正麻烦的从来不是换哪个镜像，而是 composer.lock 里残留的旧 dist URL、缓存没清、用户权限不对、或者把 resolving dependencies 当成网络问题去折腾镜像——这些点漏掉任何一个，加速就落空。
