Composer命令不识别需检查PATH和执行权限：确保/usr/local/bin在PATH中，运行sudo chmod +x /usr/local/bin/composer；非root安装需将$HOME/bin加入PATH；禁用sudo运行；避免软链，推荐mv或--install-dir直接部署；多PHP版本用封装脚本指定php路径；国内需配置阿里云镜像。
Composer 全局安装后命令不识别？检查 PATH 和执行权限
直接运行 composer --version 报 command not found，不是没装好，而是没进系统 PATH 或缺少执行权。
-
/usr/local/bin必须在当前用户的$PATH中（普通用户通常默认包含，但某些最小化系统或 Docker 容器里可能没有） - 装完必须加可执行权限：
sudo chmod +x /usr/local/bin/composer，否则 bash 会拒绝执行 PHAR 文件 - 如果用的是非 root 用户装的（比如
php composer-setup.php --install-dir=$HOME/bin --filename=composer），要确认$HOME/bin已加入 PATH，且该目录存在 - 别用
sudo composer日常操作——很多插件（如 Laravel Installer）会因 root 权限拒绝运行，报错类似Do not run Composer as root
软连接（symbolic link）能替代 mv 吗？可以，但没必要且易出错
有人想用 ln -s /path/to/composer.phar /usr/local/bin/composer 实现“软连”，理论上可行，但实际埋了三个坑：
- PHAR 文件被移动或重命名后，软链立即失效，报
No such file or directory - 某些 SELinux 或严格容器环境会阻止执行软链指向的 PHAR，报
Permission denied（即使权限位正确） - Composer 自更新（
composer self-update）会覆盖原composer.phar文件，而软链目标若被删重建，链接可能断开或指向空文件 - 真正推荐做法是：用
mv或--install-dir直接放到位，一步到位；软链更适合管理多版本 PHP 下的多个 composer 二进制（见下一条）
一台机器跑多个 PHP 版本？用带 PHP 路径的封装脚本，别硬套软链
当系统同时装了 PHP 7.4、8.2、8.3，而项目要求不同 PHP 版本执行 Composer（比如 Laravel 11 需 PHP 8.2+），composer 命令本身不感知 PHP 版本——它只是个 PHAR，靠当前 shell 的 php 命令解释执行。
- 错误做法：给每个 PHP 版本建一个软链指向同一份
composer.phar→ 执行时仍调用默认php，毫无意义 - 正确做法：写封装脚本，例如
/usr/local/bin/composer82：#!/bin/bash /data/php82/bin/php /usr/local/bin/composer "$@"
然后chmod +x /usr/local/bin/composer82，就能用composer82 install强制走 PHP 8.2 - 验证是否生效：
composer82 --version输出的 PHP version 行应显示 8.2.x
国内网络下 composer install 卡住或超时？镜像配置必须做，且优先用阿里云源
不配镜像，composer install 默认连 packagist.org（境外）和 GitHub（被干扰），90% 的失败都发生在这步，现象是卡在 Loading composer repositories with package information 或报 Connection timed out。
- 全局生效（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 别用已停更的 phpcomposer 镜像（
https://packagist.phpcomposer.com），2025 年起多数服务已下线 - 如果项目已存在
composer.json且之前没配镜像，先删掉vendor/和composer.lock再重试，否则旧 lock 文件可能锁定国外源地址 - 临时绕过镜像调试：加
-vvv参数看具体卡在哪一步，比如composer install -vvv 2>&1 | grep -i "GET\|curl"
