如何在 Windows Subsystem for Linux (WSL) 中正确安装和使用 Composer？

在 WSL 中安装 Composer 需先安装 php-cli 和 unzip，再通过官方脚本校验并全局安装到 /usr/local/bin，最后验证版本及初始化项目；常见问题包括 SSL 错误、国内源慢和权限问题。

在 WSL 中安装 Composer 很简单，关键是确保 PHP 环境已就绪、权限设置合理，并使用推荐的全局安装方式。

确认 PHP 已安装并可用

Composer 是 PHP 的依赖管理工具，必须先有 PHP 运行环境。打开 WSL 终端（如 Ubuntu），执行：

php -v

如果提示命令未找到，需先安装 PHP。例如 Ubuntu 用户可运行：

• sudo apt update
• sudo apt install php-cli unzip

注意：无需安装 Apache 或 Nginx，php-cli 就够了；unzip 用于解压 Composer 包。

用官方脚本安装 Composer（推荐）

直接下载并运行官方安装脚本，自动完成校验和全局配置：

• php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
• php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1f6133267b7b9067c888a00ce5aa39641261124005205c58f97413303' ) { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
• sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

最后一步把 composer 命令装到系统路径，所有用户都能直接调用。

验证安装并测试项目初始化

安装完成后检查是否生效：

composer --version

Copysmith

Copysmith是一款面向企业的 AI 内容创建解决方案

168

查看详情

然后尝试创建一个新项目，确认网络和权限正常：

• mkdir myproject && cd myproject
• composer init（按提示交互创建 composer.json）
• composer require monolog/monolog（安装一个包试试）

若遇到 "Could not open input file: composer"，说明路径没生效，重启终端或运行 source ~/.bashrc（或对应 shell 配置文件）。

常见问题处理

HTTPS 被拦截或 SSL 错误：WSL 可能受 Windows 防火墙或代理影响。临时跳过验证（仅调试用）：

composer config -g secure-http false

国内用户访问慢：切换阿里云或腾讯云镜像：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

权限被拒（Permission denied）：避免用 sudo composer 执行日常命令；如果安装时用了 sudo，确保当前用户对 vendor/ 和 composer.lock 有读写权 —— 通常 WSL 默认用户已满足。

基本上就这些。只要 PHP CLI 正常、脚本安装步骤不跳过校验、命令放进了 /usr/local/bin，Composer 就能稳定工作。

以上就是如何在 Windows Subsystem for Linux (WSL) 中正确安装和使用 Composer？的详细内容，更多请关注php中文网其它相关文章！