需手动将Composer目录（如C:\tools\composer\）添加到Windows系统PATH环境变量，并配置composer.bat包装器以确保正确调用PHP；同时启用php.ini中的ext-zip扩展并确认PHP版本优先级。
怎么把 Composer 加进 Windows 的 PATH？
必须手动加，安装程序默认不帮你配。哪怕你勾选了“Add to PATH”，实际也常失效——尤其是用非管理员权限安装时。
- 先确认
composer.phar文件在哪：通常在C:\ProgramData\ComposerSetup\bin\（系统级安装）或%USERPROFILE%\AppData\Roaming\Composer\vendor\bin\（用户级） - 更稳妥的做法是自己下载
composer.phar，放固定路径如C:\tools\composer\，再把这个目录加进 PATH - 打开「系统属性 → 高级 → 环境变量」，在「系统变量」里双击
Path，点「新建」，粘贴你的 composer 目录路径（不是 phar 文件路径！） - 新开一个 CMD 或 PowerShell 窗口，运行
composer --version测试；如果报'composer' 不是内部或外部命令，说明 PATH 没生效或路径写错了
为什么用 bat 包装器比直接调用 php composer.phar 更可靠？
Windows 下直接运行 php composer.phar 容易出问题：PHP 路径没配、CLI 版本和 Web 版本不一致、缺少 ext-zip 扩展等都会导致命令卡住或报错。
- 官方安装包自带的
composer.bat会自动查找系统中可用的 PHP，并设置好环境变量（比如PHP_IDE_CONFIG） - 如果你手动下载
composer.phar，建议自己建一个composer.bat放在同一目录：@echo off php "%~dp0composer.phar" %*
- 确保这个
.bat文件所在目录已加入 PATH，而不是只加了 phar 文件路径
PATH 配好了，但 composer install 还是报错找不到 ext-zip？
这是 Windows 上最典型的兼容性坑：Composer 2.x 默认依赖 ext-zip，而很多 PHP Windows 二进制包（尤其非 XAMPP/WAMP 的精简版）默认不启用它。
- 打开你的
php.ini（用php --ini查位置），取消注释这行：extension=zip - 注意不是
extension=php_zip.dll—— PHP 7.4+ 后统一用短名 - 改完后重启终端，运行
php -m | findstr zip确认模块已加载 - 如果仍不行，临时降级到 Composer 1.x（不强制依赖 zip）：
composer self-update --1
多个 PHP 版本共存时，composer 总调用错版本怎么办？
PATH 里有多个 PHP 目录时，composer.bat 会按顺序找第一个能执行的 php.exe，未必是你想要的那个。
- 运行
where php查看所有匹配的 PHP 路径，把优先级最高的那个目录放在 PATH 最前面 - 或者直接在
composer.bat里硬编码 PHP 路径：@echo off C:\php82\php.exe "%~dp0composer.phar" %*
- 别依赖
php -v输出判断——它可能和 CLI 实际调用的不是同一个二进制文件
PATH 是静态的，但 PHP 和 Composer 的交互是动态的。真正卡住人的往往不是“怎么加”，而是“加完之后谁在调用谁、用的是哪个配置”。多用 where、php --ini、php -m 确认现场，比反复重装 Composer 有用得多。
