不配镜像源的composer install在国内基本跑不通，因packagist.org受DNS污染、TLS阻断且无CDN导致刚性不可达；composer config -g repo.packagist命令需同时满足-g参数、正确键名repo.packagist、显式type值composer及URL末尾带/才生效，缺一即静默失败。
不配镜像源的 composer install 在国内基本跑不通——不是慢，是卡死在 Loading composer repositories 或 Resolving dependencies 不动。这不是网络问题，是 packagist.org 的 DNS 污染、TLS 握手阻断和 CDN 缺失导致的刚性不可达。
composer config -g repo.packagist 命令为什么总不生效
这条命令静默失败率极高，根本原因在于它必须同时满足三个硬性条件，缺一即无效：
-
-g不能省：漏了就只改当前项目目录下的composer.json，换目录或 CI 环境里完全失效 -
repo.packagist是唯一合法键名（注意是repo单数，不是repos；也不能写成packagist.org） -
composer是 type 字段值，不是 URL 一部分——写成composer config -g repo.packagist https://mirrors.aliyun.com/composer/就等于没配 - URL 必须以
/结尾：少斜杠会导致拼出/composerpackages.json这类非法路径，返回 404
正确写法只有一条：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
怎么确认镜像真的在用
别只看命令有没有执行成功，要看 Composer 实际请求的是哪个域名：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g repo.packagist，输出必须是完整 JSON 对象，含"type": "composer"和"url"字段；如果返回null、空值、https://packagist.org或报错，说明配置失败 - 再跑一次
composer install -vvv，最后几行必须出现类似Reading packages.json from cache at /https---mirrors-aliyun-com-composer/；如果还看到packagist.org/packages.json，就是 fallback 了 - 更直接的验证方式：
composer show -v | head -n 5，观察日志中真实的Downloading https://...地址
项目级配置比全局更可靠
全局配置在宝塔、Docker、CI 流水线中极易因用户权限（如 www 用户读不到 root 的 ~/.composer/config.json）或项目自带 "repositories" 字段而失效。项目级配置可提交 Git，团队拉代码后自动生效：
- 进项目根目录，执行：
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（去掉-g） - 该命令会向
composer.json顶层写入"repositories": {"packagist": {...}}，前提是原有repositories是对象结构，不是数组 - 如果
composer.json已有"repositories": []数组，别手动覆盖，否则可能删掉私有包源；改用composer config repositories.packagist composer https://...追加 - 改完记得运行
composer update --lock，让composer.lock记录新源地址
换源后还是卡在 Resolving dependencies
镜像只加速元数据下载和 ZIP 包分发，不解决依赖解析本身慢的问题。如果卡在这里，基本和镜像无关：
-
"php": "^7.4 || ^8.0"这类宽泛约束会让 Composer 尝试大量版本组合，拖慢解析 -
dev-main、dev-develop等未锁定分支会触发实时 git fetch，且不走镜像 - 项目用了已废弃的
fxp/composer-asset-plugin，它绕过 Composer 镜像机制，直连 Bower/NPM 源（这些源在国内无镜像） - 某些老项目依赖
yiisoft/yii2低版本，建议升级到 2.0.14+ 并迁移到npm-asset-packagist.org
真正卡住时，先跑 composer diagnose，它比 --version 更早暴露底层 TLS、DNS 或扩展缺失问题。
