composer安装失败主因是php.exe未加入系统path：需先运行php -v验证，若报错则手动将php.exe所在目录添加至环境变量path，重启终端后方可继续；安装推荐手动部署composer.phar并配置composer.bat，镜像配置须严格使用composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/且url以/结尾。
php.exe 找不到是 Composer 安装失败的主因
不是 Composer 装不上，而是它根本没机会运行——php.exe 不在系统 PATH 里，所有后续操作都会卡在第一步。
打开 PowerShell 或 CMD，直接运行 php --version。如果提示“不是内部或外部命令”，说明 PHP 没暴露给命令行，必须先解决这个。
- 找到你的
php.exe所在目录（例如C:\php8.2、C:\xampp\php或C:\laragon\bin\php\php-8.2.12） - 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”，在“系统变量”的
Path里新增这一行完整路径（只到目录，不带php.exe） - 关闭并重新打开所有终端窗口——旧窗口不会自动读取新
Path
再试 php --version，有输出才能继续。别跳过这步，90% 的“安装失败”实际都卡在这里。
用 Composer-Setup.exe 还是手动放 composer.phar？
官方 Composer-Setup.exe 看似省事，但容易自动选错 php.exe（比如同时装了 PHP 8.1 和 8.2，它可能默认选旧版），或者写死注册表路径导致升级后失效。
更稳妥的做法是手动部署：
- 去 https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114 下载最新
composer.phar - 把它放进固定目录，比如
C:\bin\composer.phar（C:\bin需已加入Path） - 在同一目录新建
composer.bat，内容只有一行：@php "%~dp0composer.phar" %*
这样执行 composer --version 就能调用成功，本质是用你本地的 php.exe 运行那个 .phar 文件，可控且无副作用。
配置阿里云镜像必须写对这三处
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 这条命令看着简单，但漏掉任意一个细节就会静默失效，不报错也不生效。
-
-g不能省：缺了就只改当前项目，换目录就失效 -
repo.packagist必须是单数repo，不是repos，也不是packagist.org - URL 必须以
/结尾：少斜杠会拼出https://mirrors.aliyun.com/composerpackages.json，返回 404
验证是否生效：composer config -g repo.packagist 应输出类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空或 null，说明命令写错了。
项目级镜像比全局更可靠
全局配置写在 %USERPROFILE%\AppData\Roaming\Composer\config.json，但 CI 流水线、宝塔后台、Docker 容器里跑命令的用户往往不是你当前登录用户，配置根本读不到。
进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动往 composer.json 的 repositories 字段里安全追加，不覆盖已有私有源——前提是 repositories 是对象结构（{}），不是数组（[]）。如果已经是数组，得先手动改成对象再运行。
改完记得删掉 vendor 和 composer.lock，否则旧 lock 文件里的哈希值可能和镜像元数据不匹配，导致 install 失败。
