Win11下Composer命令不可用的主因是PATH未正确配置：需手动添加C:\ProgramData\ComposerSetup\bin和%APPDATA%\Composer\vendor\bin到系统环境变量，并重启终端；同时确保PHP≥7.4且启用openssl、mbstring、json、phar扩展。
cmd 找不到 composer 命令？不是安装失败，是 PATH 没暴露给终端
这是 Win11 上 90% 新手卡住的第一步。双击 Composer-Setup.exe 装完，php -v 能用，但一敲 composer --version 就报 'composer' is not recognized as an internal or external command——问题不在 Composer，而在 Windows 的 PATH 机制没生效。
- 新版安装器默认不勾选
Add to PATH，哪怕你一路 Next 也没自动加 - 手动添加路径必须是：
C:\ProgramData\ComposerSetup\bin（注意不是C:\Users\XXX\AppData\Roaming\Composer\bin） -
C:\ProgramData是隐藏系统文件夹，资源管理器里要开启“显示隐藏的项目”才能确认路径存在 - 改完环境变量后，已打开的 cmd/PowerShell 不会 reload PATH，必须关掉重开一个新终端再试
PHP 没配好，Composer 就是空壳子
Composer 本质是个 PHP 脚本，它启动时会调用本地 php.exe。如果 PHP 版本太低、扩展缺失或路径不对，composer 命令可能直接闪退、报错或卡在初始化阶段。
- 最低要求：
php -v输出版本 ≥7.4（2026 年推荐用 PHP 8.2+） - 必须启用的扩展：
openssl、mbstring、json、phar；检查命令：php -m | findstr "openssl mbstring json phar" - 如果缺
openssl，去php.ini里取消;extension=openssl或;extension=php_openssl.dll前的分号，保存后重启终端 - 安装器若没自动识别 PHP，就点
Browse手动指定php.exe（例如：D:\laragon\bin\php\php-8.2.12\php.exe）
全局工具装了却不能直接运行？%APPDATA%\Composer\vendor\bin 没进 PATH
执行 composer global require laravel/installer 成功后，laravel 命令仍提示找不到——这不是安装失败，而是 Composer 把可执行文件放到了用户级 bin 目录，而这个目录不在系统 PATH 里。
- 全局包的二进制文件实际位置是：
%APPDATA%\Composer\vendor\bin（即C:\Users\XXX\AppData\Roaming\Composer\vendor\bin） - 必须把这个路径也加进系统环境变量
Path，和前面的C:\ProgramData\ComposerSetup\bin是两回事 - 加完同样要新开终端验证：
echo %PATH%看是否同时包含这两个路径 - 别用
composer global单独运行——它不是有效命令；真正可用的是composer global list或composer global show
换镜像源后还是连不上？先清缓存，再看 composer diagnose
国内网络环境下，composer create-project 卡在 “Could not fetch” 很常见，但根源往往不是网络本身，而是 TLS 握手失败或缓存污染。
- 先运行：
composer diagnose，重点关注curl和openssl行是否全绿；若标红，说明证书或 SSL 配置异常 - 切阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
必须紧接着执行：
composer clear-cache，否则旧缓存（含错误证书信息）仍会干扰后续请求 - 某些企业杀软或代理会劫持 HTTPS 流量，临时禁用它们再试；不建议长期用 HTTP 源（如
http://packagist.org），有安全风险
Win11 上 Composer 的核心难点从来不是安装程序本身，而是三处 PATH 的协同：PHP 的、Composer 主程序的、全局 vendor bin 的——漏一个，命令就断一层。很多人反复重装，其实只是在同一个 PATH 缺口上打转。
