Composer自v2.5.0起已彻底移除self-update命令，执行会报“command not defined”，必须通过官方安装脚本重装并校验SHA-384与GPG签名，同时确认php≥8.0、路径权限及镜像配置。
直接运行 composer self-update 很可能什么都没更新——它默认卡在旧主版本里，还常被国内镜像缓存骗过，显示 “Up to date” 却仍是 2.5.x。
为什么 composer self-update 总是不生效
最常见的原因是：你配置了阿里云等镜像源（如 https://mirrors.aliyun.com/composer/），而它们会代理并缓存 https://getcomposer.org/ 的版本响应，导致 Composer 根本没连上官方服务器校验真实版本号。
- 执行
composer --version看到的是本地记录，不是实时在线版本 - 运行
composer self-update后提示 “Up to date”，大概率是镜像返回了过期的 “最新版” - Composer 自 2.2 起默认禁用跨主版本升级，2.5.x 永远不会自动升到 2.6.0 或 3.x
先切官方源再更新，才能真正拉到新版
别跳步，顺序错了就白忙。必须先让 Composer 连上官方源校验，再触发更新。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时切回官方源：
composer config -g repo.packagist composer https://packagist.org - 执行更新：
composer self-update --stable（升到当前主版本最新稳定小版本，如 2.7.7） - 验证：
composer --version，确认输出含明确版本号（不含snapshot或beta） - 换回阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ --mirror
想升到 v3 或锁定 2.7.7？必须显式指定
composer self-update 默认只做“同主版本内小修小补”，要跨主版本或精准控制，得靠参数或版本号。
- 升到 Composer v3（需当前 ≥ 2.5+）：
composer self-update --3 - 锁定具体稳定版（如 ThinkPHP 8 明确要求的 2.7.7）：
composer self-update 2.7.7 - 降级回 v2 最新版：
composer self-update --2 - 查看所有通道：
composer self-update --list
权限错误、签名失败、命令不存在？说明 self-update 已失效
如果你看到 Command "self-update" is not defined，那不是操作问题——是 Composer 版本 ≥ 2.5.0，self-update 命令已被官方彻底移除。此时必须重装。
- 查真实路径：
which composer→ls -l $(which composer)→ 若指向/usr/local/bin或/opt/homebrew/bin，说明是系统级安装，self-update天然无效 - 重装推荐方式（带 SHA-384 校验）：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" php -r "if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6dc97f') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer php -r "unlink('composer-setup.php');" - 没 root 权限？改用用户目录：
php composer-setup.php --install-dir=$HOME/.local/bin --filename=composer，然后确保$HOME/.local/bin在$PATH前置
真正容易被忽略的点是：升级后首次运行 composer install 可能报错，尤其从 v2 升 v3 时，composer.lock 的校验逻辑变了，老项目需要重新生成锁文件；而用包管理器（apt/brew）装的 Composer，self-update 本身就不该用——得走对应包管理器更新。
