php环境未配置好则composer无法安装，需先将php.exe所在目录加入path、启用openssl和curl扩展、重启终端，再通过composer-setup.exe安装并勾选add to path，最后配置阿里云镜像源。
PHP 环境没跑通，Composer 一定装不上
Composer 不是独立程序，它本质是一个 PHP 脚本（composer.phar），必须靠 php.exe 驱动。很多人卡在第一步，不是 Composer 装坏了，而是 php -v 根本报错。
- 打开命令提示符，执行
php -v；如果提示“不是内部或外部命令”，说明 PHP 路径没进系统PATH - 找到你的
php.exe（比如C:\php\php.exe或C:\xampp\php\php.exe），把它的**所在目录**（不是文件！）加到系统环境变量Path中 - 别忘了检查
php.ini：取消注释extension=php_openssl.dll和extension=php_curl.dll，否则后续联网操作会卡在 SSL 错误或超时 - 改完环境变量后，必须新开一个 CMD/PowerShell 窗口——旧窗口的
PATH不会自动刷新
用 Composer-Setup.exe 安装，但“Add to PATH”没勾上
官方安装器确实省事，但它不会替你做决定。最关键的一步是安装向导里那个不起眼的复选框：Add to PATH。不勾，就等于白装。
- 下载地址始终以官网为准：https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114，找 “Windows Installer” 下载
Composer-Setup.exe - 安装时若 PHP 没被自动识别，点
Browse手动选php.exe（路径必须精确到可执行文件） - 务必勾选
Add to PATH，它会把C:\ProgramData\ComposerSetup\bin加入系统变量（注意：C:\ProgramData是隐藏文件夹，别手动去删或移动） - 装完立刻新开终端，运行
composer --version；如果还报错，用where composer查看系统到底在哪个路径找这个命令
能运行但连不上 packagist.org？镜像源得马上配
默认源 https://packagist.org 在境外，Windows 下 DNS 解析 + TLS 握手慢，常见现象是卡在 Loading composer repositories... 半分钟不动，甚至直接超时。
- 执行这条命令切阿里云镜像（最稳）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 想验证是否生效，可以运行
composer config -g repo.packagist，输出应为上面那串 URL - 不需要每次项目都配——
-g表示全局配置，所有项目都会走这个源 - 如果某天要换回官方源，删掉配置就行：
composer config -g --unset repo.packagist
vendor 目录生成失败？先确认当前目录权限和磁盘格式
装完 Composer 后跑 composer init 或 composer require monolog/monolog 却提示权限拒绝、无法创建目录，问题往往不在 Composer 本身。
- 避免在
C:\Windows、C:\Program Files这类系统保护目录下初始化项目——Windows 默认限制写入 - 不要在 NTFS 挂载的网络驱动器（如映射的
Z:）或 OneDrive/Google Drive 同步目录里操作，符号链接和长路径支持不稳定 - 推荐路径：例如
D:\myproject或%USERPROFILE%\Desktop\myproject，确保父目录可读写 - 如果仍失败，临时关掉杀毒软件或 Windows Defender 实时防护——某些安全软件会拦截
vendor/的批量写入行为
最容易被忽略的其实是环境变量加载时机和 PHP 扩展状态。很多人反复重装 Composer，却没意识到 php -m | findstr openssl 返回空，或者 where composer 显示的是某个旧版本残留路径。装之前先让 php 真正可用，比什么都重要。
