Composer命令未找到本质是系统PATH未包含其可执行文件路径，需检查which composer输出、PATH配置及Shell加载逻辑，Windows还需确认PATHEXT含.BAT且重启终端。
composer 命令未找到：本质是系统找不到可执行文件
不是 Composer 本身坏了，而是终端输入 composer 时，Shell 在 $PATH 列表里翻了一遍，没找到叫 composer 的可执行文件。常见现象是报错：command not found: composer 或 bash: composer: command not found。
关键判断点：运行 which composer 或 type composer，如果没输出，就确认是 PATH 问题；如果有输出（比如 /usr/local/bin/composer），那问题在别处（比如权限、PHP 环境）。
- Windows 用户注意：CMD/PowerShell 默认不读取用户级 PATH 变量的修改，改完要重启终端，或用新窗口测试
- macOS/Linux 用户注意：不同 Shell（bash/zsh/fish）加载的配置文件不同，
~/.bashrc改了，zsh 用户可能根本不会读它 - 全局安装的 Composer 二进制文件通常放在
/usr/local/bin/composer（macOS/Linux）或C:\ProgramData\ComposerSetup\bin\（Windows），确认这个路径存在且有执行权限
Linux/macOS 下 PATH 没生效：检查 Shell 配置加载链
你加了 export PATH="$PATH:/usr/local/bin"，但终端还是不认识 composer，大概率是这行没被实际加载。zsh 用户写进 ~/.bashrc 就等于白写。
- 先查当前 Shell：
echo $SHELL；再查它实际加载哪个文件：echo $0或看~/.zshrc/~/.bash_profile/~/.profile哪个存在且被 sourced - 推荐统一写到
~/.profile（它被大多数登录 Shell 读取），然后运行source ~/.profile生效 - 验证是否成功：
echo $PATH看输出里有没有你加的路径；再试composer --version
Windows 上 composer.bat 找不到：PATH 和文件扩展名都要对
Windows 不像 Unix 系统默认识别无后缀可执行文件。Composer 安装器放的是 composer.bat，而 Windows 的 PATHEXT 环境变量必须包含 .BAT（默认有，但有人会误删）。
- 确认
composer.bat文件真实存在，常见路径：C:\ProgramData\ComposerSetup\bin\composer.bat或你自定义的安装目录 - 检查
PATHEXT是否含.BAT：命令行运行echo %PATHEXT%，输出里应有.BAT（大小写不敏感） - PATH 添加方式：用「系统属性 → 高级 → 环境变量」图形界面添加，避免手动拼错分号；添加后必须新开 CMD/PowerShell 窗口，旧窗口 PATH 不会自动刷新
不想配 PATH？直接用 php 调用 composer.phar
绕过 PATH 问题最稳的方式：不依赖 composer 命令，改用 php 直接跑 composer.phar 文件。只要 PHP 装好了、能运行，这就一定可行。
- 下载最新
composer.phar：php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"→php composer-setup.php→ 得到composer.phar - 以后所有操作都这样跑：
php /path/to/composer.phar install、php /path/to/composer.phar update - 可以 alias 成短命令（zsh/bash）：
alias composer="php /full/path/to/composer.phar"，加到 shell 配置里也行，但本质还是 PATH 替代方案
PATH 配置看着简单，实际卡在 Shell 加载逻辑、Windows 扩展名策略、权限继承这些细节上。很多人反复重装 Composer，其实只是没让系统“看见”那个文件——盯住 which composer 和 echo $PATH 这两个命令的输出，比重装快十倍。
