不能用 apt install composer，因ubuntu 22.04源中版本固定为2.0.14，不支持php 8.3、--interactive及self-update，且安装于/usr/share/php/composer/导致权限不足；必须用官方脚本+sha384校验安装。
为什么不能用 apt install composer
Ubuntu 22.04 官方源里的 composer 固定为 2.0.14，不支持 PHP 8.3、--interactive、self-update 等关键特性。运行 composer install 时可能直接报 Fatal error: Uncaught Error: Call to undefined function mb_str_split()——这不是你缺扩展，是那个版本压根没适配 PHP 8.3 的函数签名。更麻烦的是，它被装在 /usr/share/php/composer/，普通用户无写权限，self-update 必然失败。
必须用官方脚本 + SHA384 校验安装
这是 Composer 官网唯一认证的安装方式，生成独立的 composer.phar，与系统 PHP 解耦：
- 先确认环境：
php -v≥ 7.2.5（推荐 8.1+），php -i | grep -E 'allow_url_fopen|zlib'两行都显示=> On - 补依赖（最小化系统常缺）：
sudo apt install unzip - 进临时目录：
cd /tmp - 下载并校验：
curl -sS https://getcomposer.org/installer -o composer-setup.php，然后HASH=$(curl -sS https://composer.github.io/installer.sig)，再运行php -r "if (hash_file('sha384', 'composer-setup.php') === '$HASH') { 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 - 清理：
rm composer-setup.php，验证：composer --version
Permission denied 95% 是属主错配，不是权限不够
终端报错里带 vendor/autoload.php 或 Writing cache file ~/.composer/cache/？别急着 chmod -R 777，先查属主：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
ls -ld vendor/→ 若第一列是drwxr-xr-x 3 root root，说明被sudo composer install污染过，执行sudo chown -R $USER:$USER vendor/ -
ls -ld $(composer config --global cache-dir)→ 若属主非你，执行sudo chown -R $USER:$USER $(composer config --global cache-dir) -
ls -ld ~/.composer→ 全属 root？直接sudo chown -R $USER:$USER ~/.composer - 修复后删掉
vendor/和composer.lock，再用普通用户重跑composer install
laravel 命令找不到？bin-dir + PATH 双检查
composer global require laravel/installer 成功，但输 laravel 报 command not found，问题出在两处：
- 查 bin 目录：
composer config -g bin-dir（默认是~/.composer/vendor/bin） - 确认该路径属主是你：
ls -ld $(composer config -g bin-dir)，否则sudo chown -R $USER:$USER $(composer config -g bin-dir) - 确保已加入 PATH：在
~/.zshrc或~/.bashrc加export PATH="$HOME/.composer/vendor/bin:$PATH"，然后source ~/.zshrc - 更稳妥做法：
mkdir -p ~/bin && composer config -g bin-dir ~/bin && export PATH="$HOME/bin:$PATH"
真正容易被忽略的是：所有 Composer 数据目录（vendor/、~/.composer/、缓存、bin-dir）必须全程由当前用户拥有，任何一次 sudo composer xxx 都可能埋下后续报错的种子。修复不难，预防才省事。
