Composer self-update --2 或 --1 无反应是因为其不支持跨大版本更新，v2.x 仅对接 v2 发布通道，输入无效参数会被忽略或报错；降级需清理 composer.lock、allow-plugins 字段及 auth.json，并确认 PHP 版本兼容性；换源失效常因项目级 repositories 覆盖全局配置，需检查并清除；镜像同步延迟与元数据缓存需手动清理或通过 -vvv 验证真实请求源。
composer self-update --2 或 --1 为什么完全没反应
它压根不是设计来跨大版本更新的。Composer 2.x 的 self-update 命令只对接 v2 发布通道，输 composer self-update --2 或 composer self-update 1.10.22 都会被底层直接忽略或报 Could not find version。这不是网络或权限问题，是机制上禁止。
常见表现包括：
- 命令执行后无输出，
composer --version仍是旧版 - 提示
Up to date，但实际没变 -
composer self-update --2在 v2.5.0+ 直接报错Command "self-update" is not defined
验证真实路径和权限才是关键：which composer + ls -l $(which composer)。只有当它指向你有写权限的 .phar 文件（比如 $HOME/bin/composer.phar），php composer.phar self-update --2 才可能成功；其余情况一律重装。
降级到 Composer 1.x 后 vendor/autoload.php 加载失败
不是 autoload 配置错了，而是 1.x 根本读不了 2.x 生成的 composer.lock 和插件配置。静默失败最典型症状就是卡在 Loading composer repositories 或报 Invalid argument。
必须同步清理三处残留：
- 删掉项目根目录下的
composer.lock—— 1.x 无法解析 2.x 的 lock 格式 - 删掉
composer.json中的allow-plugins字段 —— 1.x 完全不识别该键 - 检查
auth.json：1.x 不支持 token-based 认证，需回退为http-basic形式
另外，1.10.22 是最后一个稳定版，仅支持 PHP 5.3–7.4。如果当前 PHP 是 8.x，降级后会直接报错，别跳过这步验证。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
升级到 Composer 2.x 后 install/update 还走 packagist.org
你以为换源成功了，其实项目里一个 "repositories" 字段就把它全废了。Composer 的源优先级是：项目级 composer.json 中的 repositories > 全局配置 > 默认源。哪怕你只写了 "repositories": []，全局镜像也彻底失效。
排查步骤很直接：
- 进项目目录，运行
composer config repositories，看输出是不是你配的镜像地址 -
grep -A5 '"repositories"' composer.json，确认没硬编码旧源（比如已下线的https://packagist.phpcomposer.com） - 临时清除覆盖：
composer config --unset repositories（注意没-g），再试composer install
CI/CD 环境（如 GitHub Actions）默认不继承本地全局配置，必须在 workflow 中显式执行镜像设置命令，否则每次构建都走官方源。
换源后明明新包发布了却装不上
不是镜像坏了，是镜像同步有延迟，且 Composer 自己缓存了旧的 packages.json。阿里云、腾讯云主流镜像同步周期是 5–15 分钟，但新包首波同步常失败；更隐蔽的是元数据缓存藏在 ~/.composer/cache/repo/ 下对应镜像目录里，composer clear-cache 只清下载包缓存，不碰它。
真正刷新元数据缓存的方法只有两个：
- 手动删整个子目录：
rm -rf ~/.composer/cache/repo/https---mirrors-aliyun-com-composer - 或用
composer install -vvv滚到底部，看日志里请求的是mirrors.aliyun.com还是packagist.org—— 这才是真实行为
私有包、path 类型仓库、标记为 abandoned 的包，会绕过镜像直接回源，别误判为镜像失效。
