composer如何在Windows环境下安装_Win10/Win11安装composer详解【教程】

PHP 已就绪且 openssl 扩展已启用是 Composer 正常运行的前提：需确认 php -v 显示版本（≥8.1），php -m | findstr openssl 有输出，否则需在 php.ini 中启用 extension=openssl 并重启终端；WAMP/XAMPP 用户须在命令行验证而非仅依赖面板；Composer-Setup.exe 安装时须手动指定 php.exe 路径；安装后需验证 PATH 是否包含 C:\ProgramData\ComposerSetup\bin，并用 where composer 和直接调用 composer.phar 排错；最后务必配置阿里云镜像并测试 composer require 成功生成 vendor/ 目录。

确认 PHP 已就绪且 openssl 扩展已启用

Composer 是 PHP 脚本，不是独立程序——没 PHP 或 php_openssl.dll 关闭，安装器会静默失败，或后续执行 composer require 时直接报 SSL 错误、连接超时。

• 在 CMD 中运行 php -v，必须看到版本号（建议 ≥ 8.1）；若提示“不是内部或外部命令”，说明 php.exe 路径未加入系统 PATH
• 运行 php -m | findstr openssl，有输出即表示已启用；若无输出，打开 php.ini（用 php --ini 定位），取消注释 ;extension=openssl 或 ;extension=php_openssl.dll，保存后重启终端
• WAMP/XAMPP 用户注意：面板里启用了 OpenSSL ≠ CLI 模式启用，务必在命令行验证，而非仅靠 Apache 日志

用 Composer-Setup.exe 安装（推荐，但需手动干预路径）

官方图形化安装器仍是 Win10/Win11 下最稳的方式，但它不会“全自动”——尤其当 PHP 不在标准路径（如 C:\php）时，它大概率识别失败，必须手动指定 php.exe。

• 从官网下载最新 Composer-Setup.exe（截至 2026 年 1 月，有效链接仍为 该地址）
• 安装时勾选 Install for all users（避免权限冲突），并点击 Browse 手动定位到你的 php.exe（例如：D:\xampp\php\php.exe 或 C:\php\php.exe）
• 安装器默认将 C:\ProgramData\ComposerSetup\bin 加入用户级 PATH；如果你常用管理员权限启动 PowerShell/CMD，它可能读不到——此时需手动把该路径加进 系统变量 的 Path

验证与排错：为什么 composer --version 还是报错？

安装完成却无法调用，90% 是环境变量未生效或路径错位，不是安装失败。

无限画

千库网旗下AI绘画创作平台

下载

• 新开一个 CMD/PowerShell（旧窗口不继承新 PATH），运行 echo %PATH%，确认输出中包含 C:\ProgramData\ComposerSetup\bin
• 运行 where composer，应返回类似 C:\ProgramData\ComposerSetup\bin\composer.bat；若返回空或错误路径，说明 PATH 未写对，或你之前手动建过同名文件干扰了查找
• 运行 php "%ProgramData%\ComposerSetup\bin\composer.phar" --version —— 绕过批处理直接调用 PHAR，可快速判断是 Composer 本身问题，还是 Windows 命令解析问题

安装后必做的两件事：换镜像 + 测试依赖

默认源在国外，首次 composer require 极易卡住或失败；不测试依赖安装，等于没真正跑通流程。

• 全局切换阿里云镜像（提速明显）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 新建测试目录，执行：

  cd /d D:\test-project
  composer init -n
  composer require monolog/monolog

  成功后检查是否生成 vendor/ 和 composer.lock；若卡在 “Loading composer repositories”，大概率镜像未生效或网络策略拦截
• 注意：vendor/ 目录不应提交到 Git，记得在项目根目录加 .gitignore 并写入 vendor/