Composer换国内镜像源必须满足三个硬性条件：键名严格为repo.packagist（非repos.packagist）、type值显式写composer、URL以/结尾；否则静默回退至packagist.org，且不报错。
换国内镜像源不是“试试看”，而是composer install能跑通的前提——不配，Downloading阶段大概率卡死或报could not find package；配错，等于没配。
为什么composer config -g repo.packagist总不生效
90% 的失败源于命令漏掉三个硬性条件，且 Composer 静默回退到 https://packagist.org，不报错也不提示：
-
repo.packagist不能写成repos.packagist（多一个s就彻底失效） - 中间必须显式写出
composer—— 它是type值，不是可选参数，漏掉就 fallback 到官方源 - URL 必须是 HTTPS，且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
验证是否写入成功，直接运行：composer config -g repo.packagist。输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON；空、null、或仍是 https://packagist.org，说明没写进去。
宝塔/CI 环境里全局配置为啥不起作用
全局配置写在 /root/.composer/config.json，只对 root 用户生效。而宝塔「一键部署」、PHP 管理器、计划任务默认以 www 用户运行，CI 流水线用 runner 用户，它们根本读不到 root 的配置。
解决方法很直接：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先确认实际执行用户：在宝塔终端执行
whoami，或查日志里的 UID - 给对应用户单独配：比如是
www用户，就运行sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中，确保
composer config -g和后续composer install是同一用户执行
项目级配置怎么避免覆盖私有仓库
执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）会自动处理已有 repositories 结构：
- 如果原
composer.json是"repositories": {}，命令会转为标准数组并追加 packagist 条目 - 如果原
repositories是数组，命令会向末尾插入新项，不破坏已有的 Git 私有源或 Satis 源 - 千万别手动写
"packagist.org": false—— 这会导致基础扩展（如ext-json）校验失败
改完后必须运行 composer update --lock，否则 composer.lock 仍记录旧源地址，下次 install 还走海外。
Resolving dependencies 卡住和镜像无关
镜像只加速元数据拉取和 ZIP 包下载，不参与依赖解析。如果你发现卡在 Resolving dependencies 超过 10 秒，基本可以确定是本地约束问题：
-
php版本约束太宽，比如"php": "^7.4 || ^8.0"，会让求解器尝试大量组合 -
require-dev里塞了太多工具包，尤其含未锁定的dev-main分支 - 启用了
xdebug（运行php -v可确认），会让解析慢 5–10 倍 -
composer.lock里残留已下线包的引用，触发回退搜索 —— 此时该删vendor/和composer.lock，再跑composer install --no-cache
真正容易被忽略的是：镜像生效后，Resolving dependencies 这一步依然可能卡几十秒，但你已经没法再靠换源提速了——它完全取决于你的 composer.json 写法和 PHP 环境配置。
