对于PHP开发者来说，Composer是日常开发必不可少的工具。它是PHP官方推荐的依赖管理工具，能够帮我们快速安装、更新、管理项目第三方依赖包，彻底告别手动下载源码、拷贝文件的繁琐操作，也是Laravel、ThinkPHP、Symfony等主流框架的运行基础。
很多新手在初次安装Composer时，会遇到网络超时、命令无法识别、镜像加载失败、PHP环境不兼容等各类问题。今天这篇博文，给大家整理了2026年最新、最全平台通用的Composer安装教程，包含Windows、Mac、Linux系统安装步骤、环境校验、国内镜像配置以及常见报错解决方案，零基础也能一键搞定。
一、安装前置条件
安装Composer之前，必须确保本地已配置好PHP环境，这是核心前提：
- PHP版本要求：支持 PHP 7.2.5 及以上版本（推荐 PHP7.4/8.0/8.1/8.2 稳定版）
- 开启必要扩展：php.ini 中需开启
zip、openssl、curl扩展（绝大多数集成环境默认开启） - 环境校验：打开终端/命令行，输入
php -v，能正常显示PHP版本即环境合格
💡 温馨提示：如果是Windows集成环境（XAMPP/WAMP/PHPStudy），需确保PHP已添加到系统环境变量，否则无法全局调用php命令。
二、全平台安装教程
Composer安装分为局部安装（仅当前项目可用）和全局安装（全系统任意目录可用），推荐大家直接全局安装，一次配置永久使用。
1. Mac / Linux 系统安装（最简洁）
Mac和Linux终端命令通用，提供官方一键安装脚本，速度快、零报错，优先推荐：
打开终端，直接执行以下任意一条官方命令即可：
# 方式一：简洁推荐版
curl -sS https://getcomposer.org/installer | php
# 方式二：国内镜像加速版（网络差优先用）
curl -sS https://install.phpcomposer.com/installer | php执行完成后，当前目录会生成 composer.phar 文件，接下来执行全局配置命令，让系统全局识别 composer 命令：
# Mac系统全局移动
mv composer.phar /usr/local/bin/composer
# Linux系统全局移动
sudo mv composer.phar /usr/local/bin/composer2. Windows 系统安装（两种方式）
Windows用户提供图形化安装和命令行安装两种方式，新手优先图形化安装，零配置无脑上手。
方式一：图形化安装（推荐新手）
- 前往官方下载安装包：https://getcomposer.org/download/，下载
Composer-Setup.exe - 右键以管理员身份运行安装程序
- 选择 Install for all users，点击下一步
- 程序会自动扫描本地PHP环境，确认php.exe路径正确（可手动选择）
- 务必勾选 Add to PATH（核心步骤，否则无法全局调用）
- 一路下一步，等待安装完成，重启命令行即可
方式二：命令行安装（适合开发者）
打开CMD或PowerShell，依次执行三条命令，完成安装+清理：
# 下载安装脚本
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
# 执行安装
php composer-setup.php
# 清理安装脚本
php -r "unlink('composer-setup.php');"安装完成后，将生成的composer文件移动到PHP根目录，即可全局使用。
三、验证安装是否成功
无论哪个系统，安装完成后，重启终端/命令行（必须重启，环境变量才生效），输入校验命令：
composer -V出现 Composer 版本号（如 v2.10.2 最新版），即代表安装成功✅。
四、配置国内镜像（解决下载超时、速度慢）
默认官方镜像在国外，下载依赖极易超时、速度极慢，安装完成后必须配置国内镜像，推荐使用阿里云/PHP中文网镜像，全局生效：
终端执行全局镜像配置命令：
# 配置阿里云Composer镜像（稳定高速，推荐）
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
# 备用：PHP中文网镜像
composer config -g repo.packagist composer https://packagist.phpcomposer.com校验镜像是否配置成功：
composer config -g --list看到对应镜像地址即配置完成，后续下载依赖秒速完成。
💡 取消镜像恢复官方源命令：composer config -g repo.packagist composer https://packagist.org
五、新手必备基础命令
安装配置完成后，分享几个日常开发高频使用的Composer命令，快速上手：
# 初始化项目（生成composer.json配置文件）
composer init
# 安装项目所有依赖（读取composer.json和composer.lock）
composer install
# 安装指定依赖包
composer require 包名
# 更新所有依赖包
composer update
# 清理缓存（解决依赖报错）
composer clear-cache六、常见问题排查
1. 提示“composer不是内部或外部命令”
原因：未添加系统环境变量 / 未重启终端。解决方案：重新运行安装程序并勾选Add to PATH，重启CMD/终端。
2. 下载依赖超时、失败
原因：未配置国内镜像或缓存冲突。解决方案：执行上方国内镜像配置命令，再执行 composer clear-cache 清理缓存重试。
3. PHP扩展缺失报错
原因：未开启zip/openssl/curl扩展。解决方案：打开php.ini，取消对应扩展注释，重启服务即可。
七、总结
Composer作为PHP开发的核心工具，安装配置是入门第一步。本次教程覆盖全平台系统，步骤简洁、适配2026最新版本，核心重点记住三点：
1. 安装前确保PHP环境正常，版本满足要求；
2. 优先全局安装，方便全项目使用；
3. 安装后务必配置国内镜像，彻底解决网络问题。
配置完成后，就可以自由安装各类PHP扩展、框架依赖，大幅提升开发效率！如果安装过程中遇到报错，欢迎评论区留言交流。
