composer config -g repo.packagist 不生效的主因是键名必须为单数repo.packagist、type值必须显式写composer、url须https且末尾带/，三者缺一即静默回退官方源，验证需输出完整json对象。
配错镜像源，composer install 就会卡在 Loading composer repositories with package information —— 不是网络问题，是配置根本没生效，且 Composer 从不报错。
为什么 composer config -g repo.packagist 总是不生效
这条命令静默失败的主因就三个：键名写错、type 值漏掉、URL 缺末尾斜杠。缺一即 fallback 到 https://packagist.org，你完全不知道它没配上。
-
repo.packagist是唯一合法键名：repos.packagist（多 s）、packagist.org、Repo.Packagist全部无效 - 第二个参数必须是
composer，不是注释，不能省略，也不能写成vcs或空字符串 - URL 必须是 HTTPS 且以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼出/composerpackages.json导致 404） - 验证是否真写进去了，只看这一行输出：
composer config -g repo.packagist。正确返回必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null或报Key not found，说明失败
全局配置在宝塔 / CI / Docker 里为啥不起作用
全局配置写在 ~/.composer/config.json，但执行 composer install 的用户和你配镜像的用户经常不是同一个。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 宝塔默认用
www用户运行命令，你在终端用root或普通用户配的全局配置，www根本读不到 - CI 流水线（如 GitHub Actions、GitLab Runner）通常以
runner或容器内非 root 用户运行，sudo composer config -g写进了/root/.composer/config.json，实际构建时读的是/home/runner/.composer/config.json - 某些项目
composer.json里写了"repositories": {"packagist.org": false}，会直接屏蔽全局镜像 - PHP 环境若禁用了
proc_open或putenv（常见于宝塔或精简 Docker 镜像），config -g会直接报错，需检查php.ini并重启服务
项目级配置怎么安全写入 composer.json
项目级配置优先级高于全局，能被 Git 跟踪、CI 复现、新人拉代码即生效，才是服务器运维该依赖的配置方式。
- 进项目根目录（含
composer.json），运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 该命令会自动向
composer.json顶层的repositories字段插入镜像定义，但前提是原"repositories"是对象{}，不是数组[]；如果是数组，命令会报错，需先手动改成空对象 - 别手写
"packagist.org": false—— 这会让 Composer 彻底关掉基础包校验，一旦镜像临时不可用，composer install直接失败 - 改完必须删掉
vendor/和composer.lock，再跑composer install；update没用，它照着旧 lock 文件里的 dist URL 下载
换源后依然卡在 Resolving dependencies 怎么办
镜像只加速元数据下载（packages.json）和 ZIP 包拉取，不参与依赖解析。卡在这里，100% 和镜像无关。
- 检查
composer.json是否写了过于宽泛的版本约束，比如"php": "^7.4 || ^8.0"或"monolog/monolog": "^1.0 || ^2.0 || ^3.0"，会导致解析器穷举组合 - 确认是否启用了
require-dev中大量开发依赖，它们也会参与解析，拖慢速度 - 用
composer clear-cache && composer require monolog/monolog -vvv 2>&1 | grep "Downloading"观察真实请求域名，确认是否命中镜像地址 - 如果看到
https://packagist.org/packages.json，说明项目级repositories没生效，或者被其他配置覆盖了
最常被忽略的一点：哪怕你刚配好镜像，只要 composer.lock 里还存着旧的 dist URL，Composer 就会继续往 packagist.org 发请求——删锁文件和 vendor 是硬性步骤，绕不开。
