配镜像必须一步到位：键名repo.packagist（单数）、type值为composer、URL为HTTPS且末尾带斜杠，三者缺一不可，否则静默失败或仍走官方源。
配镜像不是“试试看”，而是必须一步到位：键名、type值、URL格式三者缺一不可，否则 composer config -g repo.packagist 静默失败，composer install 依然卡在 Downloading 或报 403/timeout。
为什么 composer config -g repo.packagist 总不生效
90% 的失败不是网络问题，是命令写错三个硬性条件：
-
repo.packagist必须是单数，写成repos.packagist或packagist.org就白配 - 中间的
composer是 type 值，不是注释，不能省略、不能替换成其他字符串 - URL 必须是 HTTPS 且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求/composerpackages.json，404 后静默 fallback 到官方源）
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍是 https://packagist.org，说明根本没写进去。
项目级配置怎么避免覆盖私有源
进项目根目录（确保有 composer.json），执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动向 composer.json 的 repositories 数组追加新项，而不是清空重写：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果原
"repositories": {}，会转为标准数组并插入packagist条目 - 如果已有私有 Git 源（如
"type": "vcs"），命令会追加到数组末尾，不破坏原有结构 - 改完必须删掉
vendor/和composer.lock—— 否则composer.lock里仍记录旧源的 dist URL，install根本不走新镜像 - 删完只跑
composer install（不是update），让 Composer 从头解析依赖、生成适配新镜像的 lock 文件
宝塔、CI、Docker 里镜像为啥还是不走
全局配置（-g）只对当前 shell 用户生效。宝塔后台用 www 用户、GitHub Actions 用 runner 用户、Docker 容器用默认非 root 用户——它们都读不到你本地的 ~/.composer/config.json。
解决方案分场景：
- 宝塔：进终端，先切换用户再配，例如
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - GitHub Actions：在 workflow 中加一步
run: composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Docker：在
Dockerfile中 RUN 这条命令，或把配置文件 COPY 进镜像的/root/.composer/config.json（注意用户权限） - 更稳妥统一的做法：直接用项目级配置（上一节方法），它写进
composer.json，所有环境天然一致
换源后还卡在 Resolving dependencies？和镜像无关
镜像只加速下载环节，不参与依赖解析。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，问题出在：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束，会让 Composer 尝试大量组合 -
require-dev里塞了太多未锁定版本的工具链（如"phpunit/phpunit": "^10.0"） - 用了大量
dev-main或dev-develop分支依赖
这类问题换任何镜像都无效。得收紧约束、锁定版本、精简 require-dev —— 镜像只是让“正确配置”跑得更快，它救不了错误的依赖声明。
