composer self-update 命令到底干了什么
它不是升级你项目里的 composer.json 或依赖，而是更新 Composer 自身的可执行文件（即 composer 这个命令本身）。本质是下载最新稳定版的 PHAR 包，替换本地的 composer.phar。
常见错误现象：composer self-update 执行后提示 “You are already using composer version x.y.z”，但实际运行 composer --version 显示旧版本 —— 很可能是你系统里存在多个 Composer 安装（比如 Homebrew 装的、手动下载的、Docker 内置的），self-update 只更新它自己找到的那个 PHAR 文件，不碰全局 PATH 里的其他副本。
- 默认只更新到最新稳定版；加
--snapshot可切到开发快照版（不推荐日常使用） - 加
--rollback可回退到上一个版本（适合更新后出问题时紧急恢复） - 若用
sudo composer self-update，说明你当初是用 root 权限安装的，后续也得用 sudo 更新，否则权限不足
全局安装的 Composer 怎么判断该更新哪个文件
Composer 启动时会通过 getenv('COMPOSER_HOME') 或默认路径（如 ~/.composer）定位自身 PHAR 的位置。但真正决定“更新谁”的，是当前 shell 中 which composer 返回的路径 —— 它指向哪个文件，self-update 就改哪个。
使用场景：你在 macOS 用 Homebrew 装了 Composer（/opt/homebrew/bin/composer），这个其实是 shell wrapper 脚本，它内部调用的是另一个 PHAR；此时 composer self-update 会更新那个被 wrapper 引用的真实 PHAR，而不是 wrapper 本身。
- 运行
which composer看命令来源 - 运行
composer --help | head -n 1看第一行是否含 “PHAR” 字样，确认是否为 PHAR 版本 - 如果
which composer返回的是/usr/local/bin/composer，但ls -l /usr/local/bin/composer显示它是软链，那就得顺着链找到真实目标再判断
为什么有时候 self-update 失败或没反应
最常见原因是网络问题导致 GitHub Release 下载超时或中断，尤其在国内。Composer 默认从 GitHub 获取 PHAR，不走镜像源 —— 即使你配置了 packagist 镜像，对 self-update 无效。
错误信息示例：file_get_contents(https://api.github.com/repos/composer/composer/releases/latest): failed to open stream: Connection refused
- 临时解决：加
-vvv查看详细日志，确认卡在哪一步 - 手动下载：去 https://getcomposer.org/download/ 找对应版本的 PHAR，替换本地文件（注意权限和文件名一致）
- 换国内镜像源：目前无官方支持，但可设环境变量
COMPOSER_HOME指向自定义目录，再用脚本预置好 PHAR（属于进阶绕过方案） - 某些 CI 环境（如 GitHub Actions）预装 Composer，禁止 self-update，必须靠 workflow 显式指定版本
升级后项目依赖突然报错？别急着回滚
新版本 Composer（尤其是 2.x → 3.x）可能默认启用更严格的依赖解析策略，或废弃某些旧字段（如 require-dev 中的 ext-* 检查逻辑变化）。这不是 bug，是语义收敛。
典型表现：composer install 报 Your requirements could not be resolved，但旧版 Composer 能过。
- 先运行
composer why-not vendor/package:version看冲突源头 - 检查
composer.json是否用了已弃用字段（如archive配置块） - 加
--ignore-platform-reqs临时跳过扩展检查，确认是否为平台约束引发 - Composer 3 默认禁用
minimum-stability的隐式 fallback，需显式写"minimum-stability": "stable"
真正容易被忽略的是：Composer 版本升级不会自动刷新 vendor/autoload.php 的加载逻辑，但如果你用了插件（如 hirak/prestissimo），它们可能已不兼容新版 —— 得一并卸载或升级插件本身。
