Composer镜像配置不生效的根本原因是命令写错：键名必须为单数repo.packagist、type值必须显式写composer、URL末尾必须带/，任一缺失即静默回退官方源且不报错。
composer config -g repo.packagist 命令为什么总不生效
不是网络慢，是命令写错就完全白配——它不会报错，但也不起作用。
-
repo.packagist必须是单数repo，写成repos.packagist或packagist.org都无效 - 中间的
composer是type字段值，不能省略；缺了它，Composer 2.x 会 fallback 到https://packagist.org -
https://mirrors.aliyun.com/composer/末尾的/不能少；少斜杠会导致请求/composer/packages.json变成/composerpackages.json，返回 404 或空响应 - 验证是否写进去了：运行
composer config -g repo.packagist，输出必须是完整 JSON（如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）或至少是那个 URL 字符串；如果返回空、null或提示 Key 不存在，说明根本没写成功
项目级配置比全局更可靠，但要注意覆盖风险
进项目根目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g），它会直接改 composer.json 的 repositories 字段。但这不是“追加”，而是全量替换。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果项目原本有私有源（比如 Git 类型的
"my-private": {"type": "vcs", "url": "..."}），这条命令会清空整个repositories，只剩阿里云镜像 - 想保留原有源？得手动编辑
composer.json，确保repositories是对象结构（不是数组），并在其中加入"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 别乱写
"packagist.org": false——它必须在顶层（和require同级），写在repositories里会彻底禁用基础包源 - 改完记得删掉
vendor/和composer.lock，再跑composer install；旧 lock 文件里的哈希是基于旧源算的，和镜像元数据不兼容
如何确认 Composer 真的在用镜像
别信“命令跑完了”，要看实际请求发到了哪个域名。
- 加
-vvv参数执行一次安装：composer install -vvv - 在输出日志里搜
GET https://，看到的是mirrors.aliyun.com还是packagist.org，一目了然 - 如果发现还是走官方源，检查是否被项目级配置覆盖了：进项目目录后运行
composer config repo.packagist；有输出说明项目自己写了源，全局配置被跳过 - CI/CD 或宝塔环境里，
composer config -g很可能写到了错误用户下（比如你用 root 配了，但宝塔用www用户跑命令），这时临时参数最稳：composer install --repository-url=https://mirrors.aliyun.com/composer/
换源后卡在 “Resolving dependencies” 不是镜像问题
镜像只加速下载和元数据拉取，不解决依赖解析慢的问题。
- 如果你发现
composer update卡在Resolving dependencies几十秒甚至几分钟，基本和镜像无关 - 常见原因：PHP 版本约束太宽（如
"php": "^7.4 || ^8.0"），让 Composer 尝试大量组合；或者require-dev里塞了太多未锁定版本的工具包 - 临时验证方法：把
composer.json里require-dev全注释掉，再跑composer update -vvv，看是否还卡——如果变快了，问题就在 dev 包上 - 真正要优化的，是锁死关键依赖版本、收紧 PHP 约束、避免
dev-main这类不稳定引用
-vvv 看真实请求，再根据输出反推哪一层出了问题。 
