composer全局换源90%失败源于命令错误：必须严格使用repo.packagist（非repos或packagist）、type值composer不可省、url须https且末尾带斜杠。
composer config -g repo.packagist 命令必须写对三个关键点
配不生效，90% 是命令敲错了，不是网络问题。这条命令里有三个硬性要求，缺一不可：
-
repo.packagist不能写成repos.packagist（多一个 s）、packagist（少 repo. 前缀）、mirror（Composer 官方根本不识别） - 中间的
composer是 type 值，不能省；漏掉它，Composer 2.x 会 fallback 到默认源，不报错但无效 - URL 必须是 HTTPS 且末尾带斜杠，比如
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠直接 404）
验证是否成功：运行 composer config -g repo.packagist，输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。空、null 或报错，说明没写进去。
全局配置在宝塔、CI 或计划任务里可能不生效
全局配置写在 /root/.composer/config.json，但它只对以 root 用户身份执行的 Composer 命令有效。而宝塔面板里「PHP 管理器」、「一键部署」或「计划任务」往往以 www 用户运行，根本读不到 root 的配置。
解决方法很直接：
- 先确认实际执行用户：在宝塔终端里用
whoami或查计划任务日志里的 UID - 再给对应用户配：比如是
www用户，就切到该用户下运行sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 环境同理，确保构建脚本中执行
composer config -g的用户和后续composer install是同一个
别指望 sudo composer config -g 写进 root 配置后，普通用户就能自动继承——Composer 不做跨用户配置共享。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
项目级配置写进 composer.json 更安全，但格式不能错
团队协作或 CI 场景下，优先推荐项目级配置，它写进 composer.json，拉代码即生效，不受执行用户影响。但手动编辑容易出错：
- 必须用
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），让 Composer 自动 merge 进repositories字段，而不是手写 JSON —— 否则可能覆盖已有的私有包源 - 如果项目已有
"repositories": []数组，命令会追加；如果是"repositories": {}对象，命令会转成标准数组格式 - 千万别加
"packagist": false，这会导致连基础包都拉不到；也不要把 URL 写成没引号的字符串或漏掉外层[]
换源后首次 composer install 报 hash 不匹配？删掉 vendor 和 composer.lock 重来即可，这是正常现象。
--repository-url 参数只对 install/update 生效，且完全绕过所有配置
临时验证镜像是否可用，或者 CI 脚本里想强制走某源，用 --repository-url 最干脆。但它有明确限制：
- 只对
composer install和composer update有效；composer require加这个参数不生效 - 加上
-vvv才能看到真实请求地址，比如composer install -vvv --repository-url=https://mirrors.huaweicloud.com/repository/php/composer/ 2>&1 | grep Downloading，否则你根本不知道它连了谁 - 它会彻底忽略
composer.json里的repositories和全局config.json，优先级最高
注意：镜像只加速下载，不解决 Resolving dependencies 卡顿。如果 composer update 慢在依赖解析阶段，和镜像无关，得去查 PHP 版本约束太宽、dev 包没锁定之类的问题。
