在 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 极慢。建议立即切换为阿里云或腾讯云镜像：
- 全局设置阿里云镜像：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 开干了。
