PHP 环境必须就绪（php -v 可运行且启用 openssl/mbstring/curl 扩展，版本 ≥ 7.4），再通过官方 Composer-Setup.exe 安装并勾选“Add to PATH”，最后重启命令行验证 composer --version。
确认 PHP 已就位，否则 Composer 一定失败
Composer 不是独立运行的程序，它本质是个 PHP 脚本（composer.phar），必须靠 php.exe 解释执行。所以第一步不是下 Composer，而是验证 php -v 能否在任意命令行窗口里直接运行并输出版本号。
- 如果报错“不是内部或外部命令”，说明 PHP 没配环境变量，先回头配好
Path（指向php.exe所在目录，比如C:\xampp\php或C:\php） - 如果能运行但提示
openssl、mbstring、curl等扩展未启用，请打开php.ini，取消对应extension=行的注释，并确保extension_dir路径正确（如extension_dir="C:\xampp\php\ext"） - PHP 版本建议 ≥ 7.4（2026 年起 Composer 2.7+ 已停止对 PHP 7.2 的支持），用
php -v看清楚主版本号
推荐安装方式：官方 Windows Installer（最省心）
别手写脚本、别手动下载 composer.phar、别折腾 composer.bat —— 官方提供的 Composer-Setup.exe 是为 Windows 量身优化的方案，自动识别 PHP、生成批处理、加进系统 Path，成功率最高。
- 去 https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114 下载
Composer-Setup.exe - 双击运行，安装时务必勾选 “Add to PATH”（这是关键一步，漏掉就得手动补）
- 安装过程中会自动探测
php.exe路径；若没找到，就手动浏览选择（例如C:\xampp\php\php.exe） - 装完不用重启电脑，但要关掉再重开命令行窗口（旧窗口不会自动加载新
Path）
手动配置环境变量：当 installer 失效或需自定义路径时
如果你跳过了 installer、用了脚本安装、或者把 composer.phar 放在了非标准位置，就必须手动把 Composer 可执行路径加入系统 Path，否则 composer --version 依然会失败。
- Composer 默认安装到
C:\ProgramData\ComposerSetup\bin（注意：C:\ProgramData是隐藏文件夹，资源管理器需开启“显示隐藏的项目”才能看到） - 右键“此电脑” → “属性” → “高级系统设置” → “环境变量” → 在“系统变量”中找到
Path→ “编辑” → “新建” → 粘贴上述路径 - 保存后新开一个
cmd或PowerShell，执行composer --version；若仍报错，运行echo %PATH%确认该路径确实在输出中
验证与常见错误：为什么明明装了却说“command not found”
装完不验证 = 白装。最常卡在“命令找不到”，表面是 Composer 问题，实际 90% 是环境变量或 PHP 依赖没到位。
-
'composer' is not recognized as an internal or external command：立刻检查php -v是否通；再检查Path里是否真有 Composer 路径；最后确认终端是新打开的 -
Could not open input file: composer.phar：说明composer.bat找不到composer.phar，常见于手动安装时把两个文件放错了目录（必须同级，且bat文件里写的路径要匹配） - 装完只能在某个目录下运行
composer：说明Path没加对，或者加到了“用户变量”而非“系统变量”，导致其他用户或新终端不可见
真正麻烦的从来不是下载那个 exe 文件，而是 PHP 环境的隐性依赖和环境变量的“看不见的生效时机”——多开一个终端，比反复重装更有效。
