必须写对三个硬性条件：键名repo.packagist（单数）、type值显式为composer、URL以https://开头且末尾带/，缺一则静默回退官方源；验证需执行composer config -g repo.packagist，输出应为完整JSON对象。
配镜像不是“试试看”，而是必须写对三个硬性条件，否则静默回退官方源，你根本不知道它没生效。
composer config -g repo.packagist 命令为什么总不生效
90% 的失败不是网络问题，是命令本身写错了。Composer 2.x 对这条命令极其严格，漏掉任意一个要素就静默 fallback 到 https://packagist.org，且不报错。
-
repo.packagist是唯一合法键名：不能写成repos.packagist（多 s）、packagist（少repo.）、mirror（Composer 不识别） -
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/"}；空、null、报错或只返回 https://packagist.org，说明根本没写进去。
宝塔、CI 或计划任务里镜像不生效怎么办
全局配置写在 ~/.composer/config.json，但它只对执行命令的用户生效。宝塔默认用 www 用户跑 PHP 管理器和一键部署，GitHub Actions 用 runner 用户，它们都读不到你本地 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写 root 配置再切普通用户运行
别指望“配一次，全环境通用”——Composer 不共享跨用户配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
项目级配置怎么安全追加而不覆盖私有源
团队协作或 CI 场景下，把镜像写进 composer.json 才可靠，但手动编辑极易出错：JSON 格式错、引号漏、误删已有仓库。
- 推荐命令自动合并：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 如果
composer.json原来是"repositories": {}（空对象），命令会自动转为标准数组并插入 packagist 条目 - 如果已是
"repositories": []（数组），命令会向末尾追加，不会破坏原有私有源 - 绝对不要写
"packagist": false：这会关掉基础包校验，导致php、ext-json等依赖无法解析
改完后建议删掉 vendor 和 composer.lock，再跑 composer install，避免旧 lock 文件里的 hash 与镜像元数据不匹配。
临时换源排查慢速问题最有效的方法
不想动任何配置，又想快速验证某个镜像是否可用、或者确认当前到底走的是哪个源，用 --repository-url 参数最直接。
- 临时指定阿里云镜像：
composer create-project laravel/laravel myapp --repository-url=https://mirrors.aliyun.com/composer/ - 加
-vvv查真实请求地址：composer update -vvv --repository-url=https://mirrors.tuna.tsinghua.edu.cn/composer/，日志里会打印出实际 GET 的 URL，一眼就能判断是否命中镜像 - 临时参数优先级最高，会覆盖全局和项目级配置，适合 CI 调试或单次测试
记住：镜像只加速元数据加载和 ZIP 下载，卡在 Resolving dependencies 是 PHP 版本约束太宽或 dev 包太多导致的，换源解决不了——那是 Composer 解析算法的事，不是网络问题。
