Composer报“不是内部或外部命令”是因PATH未正确配置或被旧版composer.bat劫持；需验证PATH是否含C:\ProgramData\ComposerSetup\bin、用where composer确认优先路径、将该路径置顶并重启资源管理器，再测试composer --version。
重启命令提示符或资源管理器后 composer 仍报“不是内部或外部命令”，说明环境变量没真正生效——这不是“重启不够”，而是 PATH 没加对、加晚了，或被其他同名文件劫持了。
确认 Composer 是否真的装进了系统 PATH
官方安装器（Composer-Setup.exe）默认会把 C:\ProgramData\ComposerSetup\bin 加进系统 PATH，但这个操作可能静默失败。别信“安装完成”弹窗，要亲手验证：
- 打开命令提示符（
cmd），运行：echo %PATH%
看输出里有没有C:\ProgramData\ComposerSetup\bin（注意路径拼写和反斜杠方向） - 如果没出现，说明安装器没写成功；如果出现了，继续往下查
- 运行
where composer—— 这才是关键：它会列出所有能被系统找到的composer可执行文件。你很可能看到不止一行，比如：C:\OpenServer\modules\php\PHP_8.1\composer.bat
这意味着 Windows 优先执行了 OpenServer 里的那个旧版
C:\ProgramData\ComposerSetup\bin\composer.batcomposer.bat，而它大概率已损坏或指向错误 PHP
手动修复 PATH 并清除冲突项
PATH 是从左到右匹配的，谁在前面谁先被执行。哪怕新路径加对了，只要前面有别的 composer.bat，就会失效。
- 按下
Win + R→ 输入sysdm.cpl→ “高级” → “环境变量” - 在“系统变量”里双击
Path，找到并删除所有含composer.bat的旧路径（尤其是 XAMPP、WAMP、OpenServer、PHPStudy 下的 PHP 目录） - 新增一条干净路径：
C:\ProgramData\ComposerSetup\bin（如果你改过安装路径，请用实际路径，例如D:\Tools\Composer\bin） - 把这一行拖到列表最顶部 —— 确保它优先于任何 PHP 目录
验证是否真生效，绕过缓存干扰
Windows 命令行会缓存可执行文件位置，即使 PATH 改了，旧终端也可能继续调用老路径。必须彻底断开再重连：
- 关闭所有已打开的
cmd、PowerShell、Git Bash、IDE 内置终端 - 按
Ctrl + Shift + Esc打开任务管理器 → 找到“Windows 资源管理器” → 右键“重新启动”（这会刷新系统级环境变量） - 再新开一个
cmd，立刻运行：where composer
应只返回一行，且是C:\ProgramData\ComposerSetup\bin\composer.bat - 接着运行：
composer --version
正常输出版本号才算成功 - 如果还失败，直接试绝对路径：
"C:\ProgramData\ComposerSetup\bin\composer.bat" --version
若这个能跑，就 100% 是 PATH 或缓存问题
Git Bash 下 composer 不认的特殊处理
Git Bash 不读 Windows 的 PATH，它用的是自己的 shell 环境变量。即使 Windows PATH 正确，Git Bash 里依然可能找不到 composer。
- 先确认 Git Bash 能否调用 PHP：
php -v
如果不行，得先配置 Git Bash 的 PHP 路径（通常需软链或 alias） - 最稳方案：在 Git Bash 中进入 PHP 安装目录（如
/c/php），新建composer.bat文件，内容为：@php "%~dp0composer.phar" %*
，再把composer.phar下载放同一目录 - 或者更简单：在 Git Bash 中运行
winpty composer（需提前装好winpty）——但这只是临时补救，不解决根本
最易被忽略的一点：PATH 修改后，不是“重启电脑”才有用，而是“所有已打开的终端进程”都得关干净；而最容易踩的坑，是以为加了路径就万事大吉，却没意识到旧服务器套件里的 composer.bat 正在悄悄覆盖你的新安装。查 where composer 永远比猜快。
