不配镜像，composer create-project 或 install 基本失败，因 packagist.org 国内不可用；必须执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，严格满足-g、单数键名、type值、末尾斜杠四要素，否则静默回退官方源。
不配镜像，composer create-project 或 composer install 基本跑不通——不是你网络差，是 packagist.org 在国内根本连不上，卡在 “Loading composer repositories” 是常态。
全局镜像配置必须写对三要素
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 才算生效，漏掉任意一个都会静默失败：
-
-g缺失 → 配置只写进当前目录的composer.json，换项目就失效 -
repo.packagist写成repos.packagist或packagist.org→ 键名错误，Composer 完全忽略 -
composer（type 值）被省略 → Composer 2.x+ 会 fallback 到官方源，命令看似成功但没用 - URL 少了末尾斜杠
/→ 请求路径拼成https://mirrors.aliyun.com/composerpackages.json，404 - 用了 HTTP 而非 HTTPS → Composer 2.0+ 默认拒绝，连接直接中断
验证是否生效：运行 composer config -g repo.packagist，输出应为完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明没写进去。
项目级配置更适合协作和 CI
全局配置在团队协作中不可靠：GitHub Actions 用 runner 用户、宝塔用 www 用户，它们读不到你本地的 ~/.composer/config.json。项目级配置写进 composer.json，所有人行为一致：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 该命令自动向
composer.json写入"repositories"字段，key 固定为"packagist"，不会覆盖已有私有源 - 如果项目已有
"repositories"数组（比如含私有包源），手动编辑时务必保留原数组结构，不要改成对象形式 - 改完后删掉
vendor/和composer.lock，再跑composer install，否则旧 lock 文件仍指向海外源
换源后仍卡在 Resolving dependencies？和镜像无关
镜像只加速元数据拉取和 ZIP 下载，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒以上，问题出在本地配置或 composer.json：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束会让 Composer 尝试大量组合 -
"monolog/monolog": "dev-main"这类未锁定的 dev 分支，每次都要重新解析 -
require-dev里塞了太多工具包，尤其含废弃插件如fxp/composer-asset-plugin - PHP 版本过低（如 7.2）或缺少
openssl、zlib扩展，导致 TLS 握手失败
这类问题换十个镜像都没用，得查 composer.json 写法或升级 PHP 环境。
别信过时镜像地址和额外工具
有些教程还在推 https://packagist.phpcomposer.com，这个源早在 2023 年就已下线，用它只会卡死或报 Could not fetch。目前稳定可用的只有阿里云、中科大、腾讯云、华为云四家镜像：
- 阿里云：
https://mirrors.aliyun.com/composer/（同步快，推荐首选） - 中科大：
https://mirrors.ustc.edu.cn/composer/（高校线路稳定） - 清华：
https://mirrors.tuna.tsinghua.edu.cn/composer/（适合北方用户） - 腾讯云：
https://mirrors.cloud.tencent.com/composer/（部分地区延迟更低）
不需要装代理、改 php.ini 或额外 CLI 工具——镜像是纯客户端配置，composer config 一条命令足矣。真正容易被忽略的是：换源后首次安装必须清掉 vendor/ 和 composer.lock，否则缓存残留会导致校验失败或包来源混乱。
