windows 下运行 composer 报“不是内部或外部命令”是因为系统未找到 composer.bat，根本原因是 path 环境变量未正确配置或 php 未就绪；需确认 composer.bat 存在于 c:\programdata\composersetup\bin 并将该目录（不带尾部反斜杠）加入系统 path，之后重启终端生效。
Windows 下运行 composer 报“不是内部或外部命令”，本质是系统找不到可执行文件，和 PATH 环境变量配置错误直接相关。
为什么 cmd / PowerShell 找不到 composer
Composer 安装后默认生成的是 composer.bat（Windows）或 composer（Linux/macOS），它本身只是一个调用 PHP 的批处理脚本。Windows 不会自动识别当前目录下的 .bat 文件，必须通过 PATH 才能全局调用。
- 你手动下载了
composer.phar但没生成composer.bat，或没放对位置 - 你安装了官方 Windows Installer（Composer-Setup.exe），但勾选了“Add to PATH”却因权限/组策略被跳过
- PATH 中添加的路径末尾多了反斜杠（如
C:\ProgramData\ComposerSetup\bin\），部分旧版 Windows 会解析失败 - 修改 PATH 后没重启终端——cmd/PowerShell 不会自动继承新环境变量
确认 composer.bat 是否真实存在
先别急着改环境变量，先定位文件：
- 打开资源管理器，访问
C:\ProgramData\ComposerSetup\bin（这是官方安装器默认路径） - 检查该目录下是否有
composer.bat和composer.phar - 如果没有，说明安装不完整，建议卸载后重装官方
Composer-Setup.exe，安装时右键选择“以管理员身份运行”并确保勾选Add to PATH - 如果存在，但路径是类似
C:\Users\XXX\AppData\Roaming\Composer\vendor\bin，那是 Composer 全局 bin 目录（用于composer global require的命令），不是主执行入口，不能加进 PATH
正确添加 Composer 到系统 PATH
只添加 composer.bat 所在的**父目录**（不是 .bat 文件本身）到 PATH：
- 按
Win + R→ 输入sysdm.cpl→ “高级”选项卡 → “环境变量” - 在“系统变量”中双击
Path→ “新建” → 粘贴路径：C:\ProgramData\ComposerSetup\bin（注意：不带结尾反斜杠） - 点击“确定”保存全部对话框
- 关闭所有已打开的 cmd / PowerShell 窗口，重新打开一个，再运行
composer --version
如果仍报错，尝试在新终端中直接运行 C:\ProgramData\ComposerSetup\bin\composer.bat --version —— 若成功，说明 PATH 没生效；若失败，说明 composer.bat 依赖的 PHP 不在 PATH 或版本太低（需 PHP ≥ 7.2.5）。
替代方案：不用 PATH，直接用完整路径调用
当无法修改系统 PATH（如公司锁死策略），或只想临时验证 Composer 是否可用时：
- 在任意目录下，直接运行：
C:\ProgramData\ComposerSetup\bin\composer.bat install - 为省事，可创建桌面快捷方式，目标设为：
cmd /k "C:\ProgramData\ComposerSetup\bin\composer.bat"，双击即进入 Composer 交互环境 - VS Code 终端默认继承系统 PATH，但如果它启动早于 PATH 修改，也需完全退出 VS Code 再重开
真正容易被忽略的点是：PATH 修改后必须新开终端，且 composer.bat 依赖 PHP 可执行文件也在 PATH 中——如果 php --version 同样报错，那 Composer 必然失败，得先解决 PHP 环境。
