Composer 命令失效？别急着重装，先查这两处
遇到“command not found: composer”先别慌，这通常不是安装包本身的问题。真相是，超过九成的类似报错，根源都指向两个地方：要么是系统找不到命令的路径（PATH），要么是文件本身没有执行权限。这和下载脚本是否正确，关系其实不大。
composer --version 报 Permission denied
这属于典型的“文件在，但没钥匙”。Linux系统不会自动给composer.phar文件加上执行权限（x），即使用sudo mv命令把它移到了系统目录也一样。
- 第一步，确认状态：运行
ls -l /usr/local/bin/composer。如果权限列显示类似-rw-r--r--（只有读写，没有执行），那就对了，问题就在这儿。 - 第二步，补上权限：执行
sudo chmod +x /usr/local/bin/composer。 - 有个细节值得注意：别用
php /usr/local/bin/composer --version来测试。这种方式能运行，并不代表直接输入composer命令就能成功。
which composer 无输出，但文件明明在 /usr/local/bin/
这种情况说明，/usr/local/bin这个目录，没有被包含在当前用户的$PATH环境变量里。在一些最小化系统、Alpine镜像或特定的Docker官方镜像中，这个路径默认是被移除的。
- 检查PATH：运行
echo $PATH | grep -o '/usr/local/bin'。如果没有任何输出，就证实了路径缺失。 - 临时解决方案：执行
export PATH="/usr/local/bin:$PATH"，当前终端会话立即生效。 - 永久生效方案（推荐）：将路径写入用户配置文件。对于Bash用户：
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。如果是Zsh用户，则将~/.bashrc替换为~/.zshrc。 - 顺便提一句，除非你明确知道后果，否则不建议直接修改
/etc/profile，因为它会影响所有用户，并且可能在系统更新时被覆盖。
composer config -g repo.packagist 失效或报错
全局镜像配置如果写错了位置或参数顺序，会导致配置被写入当前项目目录，而非全局范围。结果就是，后续执行install或update时，依然会连接国外源，导致超时或失败。
- 正确命令格式：
composer config -g repo.packagist https://mirrors.aliyun.com/composer/。关键点在于，-g参数必须紧跟在config后面。 - 两种常见错误写法：
composer config --global repo.packagist ...或composer config repo.packagist ... -g。这两种方式都会把配置写入当前项目的composer.json文件里。 - 验证配置：运行
composer config -g --list | grep repo，应该能看到repo.packagist这一行指向你设置的国内地址。 - 如果不小心写错了，补救步骤是：先删除项目级的错误配置
composer config --unset repo.packagist，然后重新执行正确的全局配置命令。
PHP 扩展缺失导致 install 卡住无报错
这个问题有点隐蔽。Composer 2.x 在启动时并不会强制检查所有必需的PHP扩展，但到了实际执行install阶段，需要解压、处理包时，才会调用ZipArchive、Phar等模块。此时如果扩展缺失，可能只会简单打印一句“zip extension is missing”，甚至直接静默退出，让人摸不着头脑。
- 必须启用的核心扩展：
php-zip、php-phar、php-xml、php-mbstring。（通常php-json和php-cli已经默认安装了） - 安装命令（按系统区分）：
Ubuntu/Debian系：sudo apt install -y php-zip php-phar php-xml php-mbstring
RHEL/CentOS 8+系：sudo dnf install -y php-zip php-phar php-xml php-mbstring - 验证扩展是否加载：运行
php -m | grep -E 'zip|phar|xml|mbstring'，确保这四个关键词都有对应的输出。
最后，分享一个最容易被忽略的要点：修改了PATH环境变量，并不等于当前的Shell会话会自动重新加载它。要让改动真正生效，你必须新开一个终端窗口、或者执行source命令重新加载配置文件、亦或是用exec $SHELL命令替换当前shell进程。三者选其一，否则之前的修改就只是“纸上谈兵”，实际并未生效。
