Composer换源不生效的根本原因只有三条：键名必须为repo.packagist（不能多s或大小写混用）、命令中必须包含composer类型声明、镜像URL必须HTTPS且以/结尾；任意一条出错都会静默回退到官方源。
composer config -g repo.packagist 为什么总不生效
根本原因就三条：键名写错、缺 composer 类型声明、URL 少末尾 /。任意一条出错，Composer 都静默回退到 https://packagist.org，不报错也不提示。
-
repo.packagist是唯一合法 key —— 写成repos.packagist（多一个 s）、Repo.Packagist（大小写混用）全无效 - 命令必须带齐三部分：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉中间的composer就等于没配 - URL 必须是 HTTPS 且以
/结尾，https://mirrors.aliyun.com/composer会 404，请求路径变成/composerpackages.json - 执行后立刻验证：
composer config -g repo.packagist输出必须是完整 JSON，不是空、不是https://packagist.org
换源后 composer update 还卡在 packagist.org？优先级和缓存坑
不是镜像没切成功，而是你项目里有 "repositories" 字段 —— 它会完全屏蔽全局配置，哪怕只是空数组 {}。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
cat composer.json | grep repositories，确认是否存在该字段；存在则删掉或改成"packagist": true -
composer clear-cache只清下载包缓存，元数据缓存藏在~/.composer/cache/repo/下对应镜像目录里，得手动删整个子目录才真刷新 - 执行
composer install -vvv，滚动到底部看日志里出现的是mirrors.aliyun.com还是packagist.org—— 这才是真实请求地址 - 私有包、
path类型仓库、标记为abandoned的包，会绕过镜像直接回源，别误判为镜像失效
composer update 升什么、怎么升才安全
composer update 不是“更新已装包”，而是丢掉 composer.lock，重新解依赖图 —— 它默认拉所有包的最新兼容版本，极易引发意外变更。
- 只升指定包：
composer update monolog/monolog guzzlehttp/guzzle - 跳过开发依赖：
composer update --no-dev - 强制忽略 lock 文件重算：
composer update --lock（等效于先删composer.lock再install） - CI/CD 流水线必须用
composer install，update会导致每次构建环境漂移 - 升之前先跑
composer outdated看哪些包有候选版本，再结合 CVE 或 bug 修复目标决定是否动
镜像延迟和本地缓存导致“明明新包发布了却装不上”
阿里云、腾讯云等主流镜像同步周期是 5–15 分钟，但新包首波可能失败；更常见的是 Composer 自己缓存了旧的 packages.json，根本不发新请求。
- 直接访问镜像地址验证，例如
https://mirrors.cloud.tencent.com/composer/p/provider-2024-07.json，搜索包名看版本是否存在 - 三步强制刷新：
composer clear-cache→ 删~/.composer/cache/repo/https---mirrors.aliyun.com-composer→composer require vendor/package:dev-main -vvv - 遇到刚打 tag 还没点 Packagist “Update” 的包，镜像也无能为力，只能切回官方源：
composer config -g repo.packagist composer https://packagist.org - 别信
composer update --with-all-dependencies能绕过缓存 —— 它照样基于已加载的 provider 数据工作
composer.json 里有没有隐藏的 repositories 字段、以及是否意识到 update 本质是重算而非升级。 
