PHP和openssl扩展需先配置好，再安装Composer并配置国内镜像。运行php --version和php -m | findstr openssl验证环境；用Composer-Setup.exe安装并勾选Add toPATH和Install for all users；全局配置阿里云镜像composer config -g repo.packagist https://mirrors.aliyun.com/composer/；初始化项目用composer init，安装依赖用composer require，vendor目录不提交Git。
确认PHP环境和openssl扩展是否就绪
Composer不是独立运行的工具，它完全依赖PHP CLI环境；很多“安装完却报错”的情况，其实根本没走到Composer这步，而是PHP自己卡住了。
常见错误现象：'composer' 不是内部或外部命令 或 php_openssl.dll could not be loaded，本质都是PHP没配好。
- 先在命令行运行
php --version，确保能输出版本号；如果提示“不是内部或外部命令”，说明php.exe没进系统PATH - 再运行
php -m | findstr openssl（Windows PowerShell可用php -m | Select-String openssl），必须看到openssl—— 如果没有，打开php.ini（用php --ini找路径），去掉;extension=openssl或;extension=php_openssl.dll前的分号 - 改完
php.ini不用重启Apache/Nginx，但得关掉所有已打开的CMD/PowerShell窗口，重新开一个再测
用官方安装器装Composer，别跳过关键选项
Windows下唯一推荐的方式就是官网的 Composer-Setup.exe，手动下载 .phar + 配 PATH + 写 .bat 是老方法，现在纯属给自己加戏。
安装时容易踩的坑全集中在向导界面：
- 务必勾选
Install for all users（否则普通用户可能没权限写全局配置） - 一定要勾选
Add to PATH—— 这是让composer命令能在任意目录敲出来的原因；如果不勾，后面得手动把C:\ProgramData\ComposerSetup\bin加进系统PATH - 如果安装器没自动识别出
php.exe，点击Browse手动找：XAMPP用户通常是C:\xampp\php\php.exe，WAMP是C:\wamp64\bin\php\php8.3.0\php.exe（版本号会变），纯PHP解压版则是你解压目录下的php.exe
验证成功后立刻配国内镜像，否则第一次 require 就卡住
默认源 packagist.org 在境外，国内直连大概率超时或极慢；这不是网络问题，是物理距离+防火墙策略决定的，不换镜像，composer require 很可能卡在 Loading composer repositories with package information 十几分钟不动。
全局配置阿里云镜像（推荐，稳定且同步及时）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：运行 composer config -g repo.packagist，应返回 https://mirrors.aliyun.com/composer/；如果提示 Could not open input file，说明 composer 命令本身还没通，先回头检查前两步。
- 中科大、腾讯云、华为云镜像也可用，地址分别是
https://mirrors.ustc.edu.cn/composer/、https://mirrors.cloud.tencent.com/composer/、https://mirrors.huaweicloud.com/repository/composer/ - 项目级镜像（只对当前目录生效）用不带
-g的命令：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
初始化项目和安装依赖，注意 vendor 目录别提交
装完就能用，但新手常忽略两个实操细节：一是 composer.json 怎么来，二是 vendor 目录该不该进Git。
最简启动方式：
- 新建空文件夹，cd 进去，运行
composer init—— 一路回车用默认值就行，会生成基础composer.json - 然后试装一个包：
composer require monolog/monolog，成功后会出现vendor/目录和自动加载文件 -
vendor/是自动生成的，**永远不要手动编辑它，也永远不要把它提交到 Git** —— 正确做法是在项目根目录加.gitignore，里面写一行vendor/ - 别人克隆你的项目后，只需运行
composer install（不是require），就会按composer.lock精确还原依赖
真正容易被忽略的是：如果你之前用其他源（比如没配镜像时）执行过 composer install，再切镜像后，得先 composer clear-cache，再 composer update --lock，否则旧缓存可能干扰新包下载。
