composer self-update 显示“up to date”却非最新版，是因国内镜像源缓存过期；需先切官方源校验再更新，最后换回镜像，且默认不跨主版本升级（如v2→v3），升v3须满足composer≥2.5.0、php≥8.0并显式执行--3。
为什么 composer self-update 总说 “Up to date” 却不是最新版
这不是命令坏了，是镜像源缓存了官方版本响应。阿里云、腾讯云等国内镜像会代理 https://getcomposer.org/，但不实时同步版本列表，导致 composer self-update 拿到的是过期的“最新版”判断。
必须先切回官方源校验，再更新，最后换回镜像：
composer config -g repo.packagist composer https://repo.packagist.orgcomposer self-updatecomposer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
只改镜像或只跑 self-update 都不行——缺一不可。
composer self-update 默认不升主版本，比如 v2 → v3
它默认只在当前主版本内滚动升级（如 2.5.8 → 2.5.12），哪怕 v3 已发布，self-update 也完全无视。这不是 bug，是设计策略。
要升 v3，得同时满足三个条件：
- 当前 Composer ≥
2.5.0（否则--3参数被忽略） - PHP ≥
8.0（v3 强制要求） - 显式执行：
composer self-update --3
升完立刻验证：composer --version，重点看末尾 commit hash 和日期，光看 3.x.x 不够可靠。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
权限错误别硬加 sudo，重装到用户目录更安全
file_put_contents(/usr/local/bin/composer): Permission denied 是路径写权限问题，不是 Composer 的错。硬加 sudo 可能破坏插件加载机制，后续更难排查。
推荐做法是卸载系统级安装，改用用户目录：
- 下载重装：
php composer-setup.php --install-dir=$HOME/bin --filename=composer - 确保
$HOME/bin在$PATH前置（echo $PATH检查） - Windows 用户用：
php "C:\Users\YourName\composer.phar" self-update，避免文件锁
升级后若命令失效，先清 shell 缓存：hash -d composer（bash/zsh）或重启终端。
CI/CD 和生产环境必须显式锁定版本
自动升级在持续集成里等于埋雷。Docker 构建时 RUN composer self-update 会导致镜像构建时间与运行时版本不一致；共享 runner 上还可能被禁用。
稳定做法是固定版本：
-
composer self-update 2.5.8（推荐用于 CI 脚本开头） - 避免
--preview或--snapshot，除非你真在调试 Composer 本身 - 想回退？
composer self-update --rollback只还原上一次备份，不可靠；降级到某旧版，唯一方式是composer self-update --version 2.2.20（注意：低于 v2.5.0 不支持该参数）
v2.5.0 是分水岭——所有精确版本控制、--3、通道切换都从它开始生效，旧版只能手动下载 PHAR 替换。
