应使用官方脚本安装Composer而非apt，因Ubuntu仓库版本陈旧（如2.2.x长期不更新）、路径冲突、升级失败、PHP 8.2+兼容问题；官方方式下载PHAR文件至$HOME/bin，配置PATH即可。
Ubuntu 上直接用 apt 装的 composer 是过时的、不可靠的，别碰它。官方明确不推荐系统包管理器安装，因为 Ubuntu 仓库里的版本长期不更新（比如 2.2.x 卡好几年），且默认装在 /usr/bin/composer，和官方推荐的全局可执行路径冲突，后续升级、权限、插件加载都会出问题。
用官方 install 命令装（推荐）
这是最稳、最可控的方式，本质是下载一个 PHAR 文件并设为可执行。过程干净，版本明确，升级也方便。
- 确保已装 PHP CLI 和依赖：
sudo apt install php-cli unzip - 运行官方一键脚本：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - 校验签名（跳过会埋坑）：
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e89b29406c6fc81170344415519f89755be6d140437fb4733c572c1a8ac170b926309893573240495a99160152272c7d697462326834a45e4153074185c85988392e448204111436ad5ec4544dc51191699409811379807846a9a102cf95f1036289877791911' ) { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" - 安装到用户目录（避免 sudo）：
php composer-setup.php --install-dir=$HOME/bin --filename=composer - 把
$HOME/bin加进$PATH（检查~/.bashrc或~/.zshrc），然后source ~/.bashrc
为什么不能用 sudo apt install composer
Ubuntu 官方源里那个 composer 包本质是 Debian 维护的“快照版”，不是上游同步。它不走 Composer 自身的升级通道，composer self-update 会失败或静默降级；更麻烦的是，它硬编码了某些旧 autoloader 行为，在 PHP 8.2+ 下可能触发 Deprecated: Required parameter $xxx follows optional parameter $yyy 类错误——这其实是老版本 Composer 对 PHP 新特性的兼容缺失，不是你代码的问题。
- 查版本：
composer --version—— 如果显示2.2.22或更低，基本可以判定是 apt 包 - 卸载它：
sudo apt remove composer && sudo rm /usr/bin/composer - 确认没残留：
which composer应该只返回$HOME/bin/composer
composer global require 的权限和路径陷阱
很多人装完就跑 composer global require laravel/installer，结果提示 Permission denied 或命令找不到。这不是 Composer 问题，是 PHP 默认把全局 vendor 放在 ~/.composer/vendor/bin/，而这个目录未必在 $PATH 里。
- 先看全局 bin 路径：
composer global config bin-dir --absolute（通常是$HOME/.composer/vendor/bin） - 把它加进 shell 配置文件：
echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc - 注意：PHP 的
open_basedir或安全模式启用时，global require会直接失败，得关掉或换用户运行
真正麻烦的从来不是“装不上”，而是装错位置后各种命令找不到、版本混用、vendor/autoload.php 加载异常——这些都源于初始那一步用了 apt。盯住 which composer 和 composer --version，比反复重装有用得多。
