composer 2.5.0+ 已彻底移除 self-update 命令，执行必报“command 'self-update' is not defined”，必须通过官方安装脚本重装更新。
composer self-update 为什么执行没反应或报错
因为 Composer 2.5.0+ 已彻底移除 self-update 命令，你敲它大概率会看到 Command "self-update" is not defined。这不是网络或权限问题，是官方主动删除——所有 2.5.x 及之后版本都不再支持该命令。
常见误操作包括：
- 反复用
sudo composer self-update强行重试 → 依然报错 - 以为只是本地安装异常，卸载重装 apt/brew 安装的 Composer → 结果卡在旧版（如 2.2.20）
- 照着 2021 年的老教程执行 → 白费时间
真正有效的升级路径只有一条：确认安装方式，再选对应动作。先运行这两条命令：
which composer ls -l $(which composer)
结果分三种情况：
-
/usr/bin/composer且是系统级软链接 → 说明你用的是包管理器安装（apt/brew/宝塔），self-update天然不可用 -
$HOME/.local/bin/composer且指向一个 PHP 文件 → 很可能是官方脚本装的，但已过期，需重装 - 输出为空或报错 →
composer没正确加入$PATH，先解决环境问题
升级 Composer 本身：安全覆盖而非碰运气
无论当前版本多旧，都按这个流程走，不依赖任何配置文件：
- 先备份旧版：
composer --version记下当前版本，再执行mv $(which composer) $(which composer).bak - 用官方脚本重装最新稳定版：
curl -sS https://getcomposer.org/installer | php（生成composer.phar） - 移动到可执行路径：
mv composer.phar $HOME/.local/bin/composer（确保$HOME/.local/bin在$PATH中）
注意：composer self-update --rollback 在新版中已失效，回滚只能靠手动恢复备份文件。
升级后务必检查 PHP 版本：php -v。Composer 2.9.6 要求 PHP ≥ 8.0，若仍在用 PHP 7.4，首次运行就会因 Attribute 语法报错，不是升级失败，而是环境不匹配。
全局 CLI 工具怎么更新才不丢、不冲突
composer global update 经常静默退出、版本不变，是因为它只依据 ~/.composer/composer.json 的版本约束更新——而该文件通常根本不存在，或版本号写死了（比如 "laravel/installer": "^4.0"），拉不到 v5.x。
推荐做法是显式重装，而不是依赖 global update 碰运气。以升级 laravel/installer 为例：
- 查当前版本：
laravel --version或composer global show laravel/installer - 查最新稳定版：
composer global show laravel/installer --all（看latest标记） - 重装指定版本：
composer global require laravel/installer:^5.0 --update-with-dependencies
--update-with-dependencies 很关键：否则可能只升主包，留下冲突的旧依赖（比如新 laravel/installer 要 symfony/console ^6.0，但旧 phpunit 还锁着 ^5.4）。
PATH 和 bin-dir 失效，命令还是找不到
即使 composer global require 成功执行，你也可能遇到 command not found: laravel——问题不在安装，而在系统找不到二进制文件。
确认 ~/.composer/vendor/bin/ 是否在 $PATH 中：echo $PATH | grep -o "$HOME/.composer/vendor/bin"。若无输出，需补进 shell 配置（如 ~/.zshrc）：
export PATH="$HOME/.composer/vendor/bin:$PATH"
改完记得重载：source ~/.zshrc（或 source ~/.bashrc）。别忘了检查是否用了多个 shell 配置文件（比如 .zprofile 也可能影响 $PATH），这是最容易被忽略的一环。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
