直接运行 composer self-update 通常不能升到真正需要的版本，因它默认只更新同主版本内小版本，且易被国内镜像源缓存误导而误判“up to date”；需先切官方源校验、再执行更新，并显式指定 --3 或具体版本号才能跨主版本升级或精准锁定版本。
直接运行 composer self-update 通常不能升到你真正需要的版本——它大概率卡在旧主版本里，或者被镜像源缓存骗过，显示“Up to date”却仍是 2.5.x，而 ThinkPHP 8 或 Laravel 11 已要求 Composer 2.7+。
为什么 composer self-update 总是提示 “Up to date” 却没更新？
最常见原因是配置了国内镜像源（如阿里云），它们会代理并缓存 https://getcomposer.org/ 的响应，导致 Composer 根本没连上官方服务器校验版本号。
- 先临时切回官方源：
composer config -g repo.packagist composer https://packagist.org - 再执行：
composer self-update - 升级成功后立刻换回阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
--mirror参数只影响包下载阶段，不解决校验逻辑问题，不能替代切源操作
如何升到 v3 或锁定 v2.7.7 这类明确版本？
composer self-update 默认只在当前主版本内更新小版本（如 2.5.8 → 2.5.12），不会跨主版本。v3 是不兼容 v2 的重大变更，必须显式指定通道或版本号。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 升到最新 v3：
composer self-update --3（注意是两个短横线 + 数字 3） - 但前提是当前 Composer ≥ 2.5+，否则不识别
--3；旧版需先composer self-update升到 2.5+ 再执行 - 锁定具体稳定版：
composer self-update 2.7.7（版本号必须精确匹配 GitHub Release tag） - 降级回 v2 最新版：
composer self-update --2 - 查看所有可用通道：
composer self-update --list
Permission denied 或 Signature mismatch 怎么办？
这三类底层问题常导致 self-update 静默失败：PHP 版本太低、文件权限不足、签名验证失败。错误信息却很模糊。
-
Permission denied：别急着加sudo；优先重装到用户目录：php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"&&php composer-setup.php --filename=composer --install-dir=$HOME/bin，再确保$HOME/bin在$PATH前置 - PHP 版本不兼容：Composer 2.5+ 要求
php ≥ 8.0；若仍在用 PHP 7.4，升级后首次运行就会因Attribute语法报Fatal error；应先升级 PHP，或临时降级：composer self-update 2.4.4 -
Signature mismatch：可能是网络截断或证书问题；加-vvv查日志，或清理缓存；生产环境禁用--no-sig-check
CI/CD 和 Docker 环境里怎么安全升级？
自动更新在流水线里是高危操作——多 job 共享缓存、镜像构建时间固定、无交互提示都会导致失败或非预期行为。
- 不要在
Dockerfile中写RUN composer self-update；应在运行时或 CI 脚本中显式控制 - GitHub Actions / GitLab CI 必须加
--no-interaction：composer self-update --no-interaction - 升级后务必验证：
composer --version看输出末尾 commit hash 和日期，别只信版本号 - v3 首次运行
composer install可能报The lock file does not contain required hash；需先composer update --lock重生成
真正麻烦的从来不是命令本身，而是它悄悄依赖的三样东西：PHP 版本是否 ≥ 8.0、~/.composer 目录权限是否属当前用户、镜像源是否干扰了版本校验——漏掉任何一个，self-update 就会安静地失败。
