composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名严格为单数 repo.packagist、第二个参数必须显式写 composer、URL 必须 HTTPS 且末尾带 /，缺一即静默回退官方源；验证需输出完整 JSON 如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 为什么总不生效
它不报错，但 composer install 还是卡在 Downloading https://codeload.github.com/——根本原因是命令写错一个字符就静默回退到官方源。Composer 2.x 对配置极其严格：
-
repo.packagist是唯一合法键名，写成repos.packagist（多一个 s）、packagist或大小写混用（如Repo.Packagist）全部无效 - 第二个参数必须显式写
composer，漏掉它等于没配：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅；composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌ - URL 必须以
https://开头，且末尾带/：https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（拼路径会变/composerpackages.json，404）
验证是否真生效：运行 composer config -g repo.packagist，输出必须是完整 URL 字符串或类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的 JSON。空、null、或仍是 https://packagist.org，说明压根没写进去。
配了镜像却还是卡在 Downloading，怎么办
镜像只代理元数据（packages.json），不托管 ZIP 包。国内访问 GitHub 原地址仍慢，而 composer.lock 里存的 dist.url 还是旧的 GitHub 地址——这是最常被忽略的环节。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须删掉
composer.lock和vendor/目录，再跑composer install，否则旧dist.url照用不误 -
--repository-url参数对已有composer.lock完全无效，它只影响元数据拉取阶段 - 执行
composer clear-cache清掉本地缓存的旧元数据，尤其当你试过多个镜像但没生效时 - 如果项目用了私有 Git 源，删
composer.lock后要确认composer.json的repositories字段仍完整，否则某些包会直接不可见
项目级配置怎么安全加镜像又不丢私有源
直接运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）是相对安全的做法，它会自动处理 repositories 格式：
- 若原
composer.json中"repositories": {}是对象格式，命令会转为标准数组，并把阿里云镜像加在首位 - 若原
"repositories": []是空数组，命令会在末尾插入新项，不破坏已有私有源 - 千万别手动写
"packagist.org": false在repositories内部——这会导致基础扩展（如ext-json）校验失败 - 改完后建议运行
composer update --lock，确保composer.lock记录的是新镜像地址
宝塔、CI、Docker 里镜像为啥不起作用
全局配置写在 ~/.composer/config.json，但它只对当前用户生效。宝塔默认用 www 用户执行，GitHub Actions 用 runner，Docker 容器里可能是 www-data——它们根本读不到你本地 root 或个人用户的配置。
- 先确认实际执行用户：在宝塔终端里运行
whoami，或查 PHP 管理器日志里的 UID - 给对应用户单独配：比如宝塔用
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中不要依赖全局配置，改用项目级配置 +
--repository-url临时覆盖更可靠 - Docker 构建时，在
Dockerfile中用对应用户身份执行配置命令，而不是 COPY 本地config.json
最易被忽略的点：镜像配置只是链路一环，composer.lock 里的 dist.url 和执行用户的配置权限，才是卡住下载的真正瓶颈。不清理锁文件、不确认执行身份，换再快的镜像也没用。
