在 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
然后尝试创建一个新项目，确认网络和权限正常：
- 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 就能稳定工作。
