不配国内镜像，composer install卡在Loading或Downloading是常态，因packagist.org在国内DNS慢、TLS超时、首字节延迟高；必须同时满足repo.packagist键名正确、显式指定type为composer、URL以https://开头且末尾带/三个条件才生效。
不配国内镜像，composer install 卡在 Loading composer repositories 或 Downloading 是常态，不是网络差，是 packagist.org 在国内根本不可靠——DNS 解析慢、TLS 握手超时、首字节延迟常 >300ms，配置必须同时满足三个硬性条件才生效。
为什么 composer config -g repo.packagist 总是静默失效
这条命令不报错，但实际没走镜像，90% 是因为漏掉以下任一条件：
-
repo.packagist键名必须是单数、全小写；写成repos.packagist、packagist.org或Repo.Packagist全部无效 - 第二个参数必须显式写
composer（这是type值，不是注释或可选别名） - 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/"}，要么是纯 URL 字符串（新版行为）。返回空、null、Key not found 或仍是 https://packagist.org，说明根本没写进去。
项目级配置怎么安全追加镜像而不破坏私有源
全局配置在宝塔、CI、Docker 等多用户环境下极易失效（比如宝塔用 www 用户运行，但你配的是 root 的配置），项目级更可靠，且能提交到 Git 同步生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目根目录（确保有
composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 如果原
composer.json是"repositories": {}，命令会自动转为标准数组并插入 packagist 条目 - 如果原
composer.json是"repositories": []，命令会向数组末尾追加，不覆盖已有 Git/VCS 源 - 千万别手动写
"packagist": false——这会导致ext-json、php等基础扩展校验失败
改完后建议删掉 vendor/ 和 composer.lock，再跑 composer install -vvv，否则旧 lock 文件里的哈希可能和镜像元数据不匹配。
宝塔、CI、Docker 里镜像为啥还是不生效
全局配置 composer config -g 写的是当前用户的 ~/.composer/config.json，而宝塔默认以 www 用户运行，CI 流水线用 runner 或 git 用户，Docker 容器里可能是 www-data 或自定义用户——它们都读不到你本地 root 或个人账户下的配置。
- 排查方法：在对应环境里先切到实际执行用户，例如：
sudo -u www whoami，再运行composer config -g repo.packagist - 给
www用户配镜像：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中别依赖全局配置，改用临时参数：
composer install -vvv --repository-url=https://mirrors.aliyun.com/composer/
另外，宝塔面板里 composer install 卡住，还可能是 PHP CLI 环境本身瘫痪：检查「PHP 管理」→「禁用函数」页签，确认没禁用 putenv、proc_open、pcntl_signal ——这三个函数被禁会导致 Composer 启动即崩溃，根本走不到镜像环节。
换源后仍卡在 Resolving dependencies？那和镜像无关——镜像只加速下载（Downloading、Fetching package），不解决依赖解析慢的问题。这时候该查 composer.json 里有没有过于宽泛的版本约束，或者本地 PHP 扩展是否缺失（比如 mbstring、xml）。
