Composer config -g repo.packagist 失效主因是键名必须为单数repo.packagist、type值composer不可省略、URL须HTTPS且以/结尾，三者任一错误即静默回退官方源。
composer install 卡在 “Loading composer repositories” 或反复重试下载，不是你网络差，是默认源 https://packagist.org 对国内用户 DNS 解析慢、TLS 握手不稳定、CDN 距离远——换镜像就能解决，但配错一个字符就等于没配。
composer config -g repo.packagist 命令为什么总不生效
不是网络问题，是命令写错三处就静默失败：不报错、不提示、也不写入配置。
-
repo.packagist必须是单数、小写、无s：写成repos.packagist或packagist.org都无效 - 中间的
composer是type值，不是可选参数，漏掉就会 fallback 到官方源 -
URL必须是HTTPS且末尾带/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出/composerpackages.json导致 404）
验证是否成功：运行 composer config -g repo.packagist，输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或至少是完整 URL 字符串；返回空、null 或仍是 https://packagist.org，说明根本没写进去。
项目级配置比全局更可靠，尤其在 CI 和协作中
GitHub Actions、GitLab CI、宝塔面板默认以 www 或 runner 用户运行，它们根本读不到你本地用户的全局配置。项目级配置写进 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": []数组结构，这条命令会失败；此时需手动编辑，在数组中追加一条：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 改完后删掉
vendor/和composer.lock，再跑composer install（不是update）
换源后仍卡在 “Downloading https://codeload.github.com/” 怎么办
镜像只代理元数据（packages.json），不托管 ZIP 包。现象是日志里出现 Downloading https://codeload.github.com/ 且耗时超 10 秒，说明 composer.lock 里还记着原始 GitHub 地址。
-
composer.lock记录的是 dist URL，换镜像后必须删掉它和vendor/，再跑composer install才能生成新地址 -
--repository参数对已存在的composer.lock完全无效，它只影响元数据拉取环节 - 某些包（如私有 Git 仓库、GitHub 直链包）不走 Packagist，镜像对其无效；这类包需单独定义
repositories或用platform模拟扩展
换源后还卡在 “Resolving dependencies”？和镜像无关
镜像只加速下载环节（Downloading、Fetching package），不解决依赖求解慢的问题。如果你发现 composer update 卡在 Resolving dependencies 超过 10 秒，大概率是以下原因：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束会让 Composer 尝试遍历大量候选版本 -
require-dev里塞了太多未锁定的 dev 包（比如phpunit/phpunit不带具体版本） - PHP 版本太低（如 PHP 7.2），而某些包的最新版已放弃支持
- Xdebug 启用中：会让解析慢 5–10 倍，可用
php -d xdebug.mode=off $(which composer) install临时禁用
这些都得收紧约束、拆分 dev 包、或用 composer update --with-dependencies 限定范围，换任何镜像都没用。
