Windows下composer命令无效，90%因composer.phar未加入PATH或安装时未勾选“Add to PATH”；需检查where composer、PHP路径及版本、bat文件内容、php.exe而非php-win.exe，并修正PowerShell执行策略。
直接结论：Windows 下 composer 命令无效，90% 是因为 composer.phar 文件没被加入系统 PATH，或安装时未勾选「Add to PATH」——不是 PHP 没装好，也不是 Composer 本身坏了。
确认 Composer 是否真被安装到本地
很多人以为双击 Composer-Setup.exe 就算装好了，其实它只是把 composer.phar 放进某个目录（比如 C:\ProgramData\ComposerSetup\bin\），但不会自动加环境变量。运行以下命令检查：
where composer
如果返回空，说明系统根本找不到 composer 可执行文件；如果返回类似 C:\ProgramData\ComposerSetup\bin\composer.bat，说明已注册，问题可能出在 bat 文件指向的 PHP 路径错误。
- 打开该
composer.bat，看第一行是否是类似@php "%~dp0composer.phar" %* - 确保
%~dp0对应目录下确实存在composer.phar - 用
php -v确认 PHP 已在PATH中且版本 ≥ 7.2.5（Composer 2.x 最低要求）
手动添加 Composer 到系统 PATH 的正确姿势
不依赖安装器，最稳的方式是自己指定路径并加入环境变量。推荐把 composer.phar 放进一个固定位置，比如 C:\bin\（需提前创建）：
- 从 https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114 下载最新
composer.phar - 把它复制到
C:\bin\composer.phar - 在
C:\bin\下新建文本文件，命名为composer.bat，内容为：@echo off php "%~dp0composer.phar" %*
- 按
Win + R→ 输入sysdm.cpl→ 「高级」→ 「环境变量」→ 在「系统变量」中找到Path→ 编辑 → 新增一行：C:\bin
完成后重启终端（CMD/PowerShell），再运行 composer --version。
为什么用 php.exe 而不是 php-win.exe？
Windows 下 PHP 有两个可执行文件：php.exe（控制台模式，带 stdout/stderr）和 php-win.exe（GUI 模式，不输出内容）。Composer 的 .bat 必须调用 php.exe，否则会静默失败、无报错、命令卡住。
- 检查当前
php命令是否指向正确的可执行文件：where php
- 如果返回的是
php-win.exe，说明你安装 PHP 时勾选了「Add PHP to PATH」但用了 GUI 版本 —— 需手动删掉该路径，改为指向含php.exe的目录（如C:\php） - Composer 运行时依赖标准输出流，
php-win.exe会吞掉所有 echo 和错误提示，导致看起来“命令无效”
PowerShell 下 composer 命令仍报错？试试这个绕过方案
PowerShell 默认禁止运行本地脚本（包括 .bat），会提示 File cannot be loaded because running scripts is disabled。这不是 Composer 的问题，而是 PowerShell 执行策略限制：
- 临时允许当前会话执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
- 或者干脆用 CMD 运行 Composer（它不校验脚本策略）
- 更彻底的解法：把
composer.phar改成直接用 PHP 调用，例如定义别名：function composer { php "C:\bin\composer.phar" @args }（加到$PROFILE中）
真正容易被忽略的点是：Composer 的 Windows 支持高度依赖批处理文件与 PHP 控制台可执行性的配合，任何一环断掉（PHP 路径错、用错 php-win、PATH 没刷新、PowerShell 策略拦截），都会表现为「命令无效」——但它其实什么都没报错，只是安静地消失了。
