windows上composer报错90%是path未正确配置composer.bat目录、php调用错误或扩展未启用；需先验证path是否含c:\programdata\composersetup\bin、php.exe是否可用且openssl等扩展已开启，再重装。
Windows 上 Composer 报错，90% 不是安装失败，而是 PATH 没加对、php.exe 调用错、或扩展没启用——重装 Composer 之前，先查这三处。
composer 不是内部或外部命令？先确认 PATH 加的是 composer.bat 所在目录
错误现象：composer --version 报 “不是内部或外部命令”，但 php -v 正常。本质是系统根本没找到 composer.bat 文件。
- 打开文件资源管理器，输入
%PROGRAMDATA%\ComposerSetup\bin（需开启“显示隐藏的项目”），确认里面有composer.bat和composer.phar - 把这个完整路径（只到
bin目录，不含文件名）粘贴进「系统变量」→Path→ 新建：例如C:\ProgramData\ComposerSetup\bin - 别加错成
php.exe所在路径（如C:\php），也别多加反斜杠或空格（C:\ProgramData\ComposerSetup\bin\末尾有空格会失效） - 改完必须关闭所有已打开的 CMD/PowerShell/VS Code 终端，再新开一个，否则旧进程不读新
PATH - 验证：运行
echo %PATH%看输出里有没有你刚加的路径；再跑where composer，应返回类似C:\ProgramData\ComposerSetup\bin\composer.bat
composer install 卡在 “Resolving packages…” 或报 SSL 错误？PHP 扩展没启
错误现象：执行 composer install 或 composer update 时卡住、超时、或提示 “The openssl extension is required”。这不是网络问题，是 PHP CLI 缺必要扩展。
- 运行
php --ini查出当前生效的php.ini路径，用记事本打开它 - 取消以下三行前面的分号：
extension=openssl、extension=curl、extension=mbstring（ext-zip也要开，Composer 2.x 强依赖） - 确认
extension_dir指向正确，例如extension_dir="C:\php\ext" - 重启终端，运行
php -m | findstr openssl，能看到openssl才算生效 - 特别注意：别改错
php.ini—— Windows 下常存在多个 PHP（XAMPP、独立 zip 包、WSL），php -v和where php输出的路径，才是你要改的那个
composer global require 安装的命令（如 laravel）找不到？PATH 漏加了 vendor/bin
错误现象：composer global require laravel/installer 成功，但 laravel -V 仍报 “不是内部或外部命令”。这是因为全局命令不放在 Composer 自身目录，而放在 COMPOSER_HOME\vendor\bin。
- 运行
composer config --global home查出全局根目录，通常是C:\Users\用户名\AppData\Roaming\Composer - 把
%APPDATA%\Composer\vendor\bin（或你实际得到的路径 +\vendor\bin）单独加进「用户变量」里的Path - 别和 Composer 自身的
bin目录混为一谈：前者放laravel.bat，后者只放composer.bat - 加完同样要关终端重开，再运行
echo %PATH%确认该路径已出现 - 如果
%APPDATA%\Composer\vendor\bin里没有laravel.bat，说明global require实际失败了，检查是否包声明了"bin"字段，或是否有写入权限
国内用户第一次 run create-project 就卡死？默认源没换镜像
错误现象：composer create-project laravel/laravel myapp 卡在 “Loading composer repositories…” 几分钟不动。这不是 Composer 坏了，是直连 packagist.org 在国内极慢或被干扰。
- 执行一次全局镜像切换：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应输出阿里云地址 - 如果后续想恢复官方源，运行：
composer config -g --unset repos.packagist - 注意：换镜像只解决元数据拉取慢的问题，不解决 PHP 扩展缺失或 PATH 错误——这两类问题优先级更高，别本末倒置
- Windows Defender 可能严重拖慢
composer update，建议将%APPDATA%\Composer和项目目录添加到 Defender 排除列表
最常被忽略的点：PATH 改了但终端没重开、php.exe 和 php-win.exe 混用、COMPOSER_HOME 设了相对路径或含 %USERPROFILE%。这些细节不处理，其他配置全白搭。
