如何在WSL (Windows Subsystem for Linux) 中正确安装和使用Composer？（环境配置）

在 WSL 中安装 Composer 需确保 PHP ≥ 7.2.5（推荐 ≥ 8.0），先用 apt 安装 php-cli 等依赖，再通过官方脚本下载并移至 /usr/local/bin；建议配置阿里云镜像加速，并排查 PATH、扩展缺失或权限问题。

在 WSL 中安装 Composer 很简单，但要注意路径、权限和 PHP 环境是否就绪。只要 PHP 已安装且版本 ≥ 7.2.5（推荐 ≥ 8.0），Composer 就能正常运行。

确认 PHP 和依赖已安装

Composer 是 PHP 的包管理工具，必须先有可用的 PHP 环境：

• 运行 php -v 检查是否已安装 PHP 及版本（如 Ubuntu 默认可能没装）
• 若未安装，用 sudo apt update && sudo apt install php-cli unzip 安装核心组件
• 可选：安装常用扩展，比如 sudo apt install php-mbstring php-xml php-zip（多数 Laravel 或现代项目需要）

下载并全局安装 Composer

推荐使用官方安装脚本完成全局部署，避免后续每次都要指定路径：

• 执行 curl -sS https://getcomposer.org/installer | php 下载安装器
• 将生成的 composer.phar 移到系统路径：sudo mv composer.phar /usr/local/bin/composer
• 运行 composer --version 验证是否生效（显示版本号即成功）

配置国内镜像（提速关键）

默认源在国外，首次 install/update 极慢。建议立即切换为阿里云或腾讯云镜像：

图酷AI

下载即用！可以免费使用的AI图像处理工具，致力于为用户提供最先进的AI图像处理技术，让图像编辑变得简单高效。

106

查看详情

• 全局设置阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 验证是否写入：cat ~/.composer/config.json（应看到 mirror 地址）
• 临时切换回官方源可用 composer config -g --unset repos.packagist

常见问题与修复

遇到报错别急着重装，多数是环境细节没对齐：

• "command not found: composer" → 检查 /usr/local/bin 是否在 $PATH 中（执行 echo $PATH，若无则加到 ~/.bashrc 或 ~/.zshrc）
• "Mcrypt PHP extension required" → 这是老项目要求，PHP 7.2+ 已弃用；改用 php-sodium 或在 composer.json 中加 "config": {"platform": {"ext-mcrypt": "7.2.0"}} 跳过检查
• 权限错误（如 /tmp 权限不足） → 执行 sudo chmod -R 777 /tmp（仅调试用，生产环境不建议）或换用 COMPOSER_CACHE_DIR 指向用户目录

基本上就这些。WSL 里 Composer 和原生 Linux 几乎无差别，关键是 PHP 环境干净、PATH 正确、镜像配好。装完就能直接 composer create-project laravel/laravel myapp 开干了。

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