wsl2中安装composer需先确保php、curl、unzip已安装并配置ca证书，再用官方脚本下载composer.phar、移至/usr/local/bin/composer并赋执行权限；禁用apt安装因版本老旧不兼容现代框架，中文路径安全但含空格需加引号。
WSL2 里装 Composer 就是标准 Linux 安装，中文兼容问题基本不存在——真正卡住你的，通常是 PHP 配置、证书或权限。
composer安装失败常见报错及对应操作
执行 curl -sS https://getcomposer.org/installer | php 后报错，多数不是 Composer 本身的问题，而是底层依赖没到位：
-
cURL error 60：CA 证书过期或缺失 → 运行sudo apt update && sudo apt install -y ca-certificates -
Could not open input file: composer.phar：脚本下载失败或被拦截 → 改用php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"+php composer-setup.php -
command not found: composer：没加sudo或漏了chmod +x /usr/local/bin/composer→ 检查ls -l /usr/local/bin/composer是否有x权限位 -
Allowed memory size exhausted：PHP 内存限制太低 → 编辑php --ini输出的Loaded Configuration File，把memory_limit = 128M改成memory_limit = 2G
为什么不能用 apt install composer
Ubuntu 官方源里的 composer 包版本老旧（常为 1.x 或极旧 2.x），运行 composer install 时大概率报 Package manifest version mismatch。这不是你项目写错了，是源码和 lock 文件格式不兼容。
官方脚本安装会直接拉取最新稳定版（当前为 2.7.x），且自动校验 SHA384 哈希值，安全性与一致性都有保障。别图省事走 apt，多敲三行命令换半年不踩坑更划算。
中文路径/文件名是否安全
WSL2 默认使用 UTF-8 编码，composer.json 里写中文包名、中文注释、甚至项目路径含中文（如 /home/user/我的项目）完全没问题 —— Composer 本身不解析路径语义，只调用 PHP 的 file_get_contents 和 proc_open，而这些函数在 WSL2 的 ext4 分区上对 UTF-8 支持良好。
唯一要注意的是：composer create-project 如果指定目标目录含空格或中文，务必用引号包裹，例如：composer create-project laravel/laravel "我的新项目"。不加引号会导致 shell 把空格当分隔符，命令直接崩。
国内网络下必须做的两件事
不配镜像，composer install 可能卡死十分钟以上，甚至超时失败：
- 全局切换阿里云源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 关掉 HTTPS 强制校验（仅临时调试用）：
composer config -g secure-http false，避免某些企业网络中间设备篡改证书导致连接中断
注意：secure-http false 是临时手段，切勿长期开启；镜像源配置后，所有新项目自动生效，无需每个项目重复设置。
真正容易被忽略的点：改完 php.ini 后，别只重启 PHP-FPM 或 Apache —— Composer 走的是 CLI 模式，必须确保 php -v 和 php --ini 看到的是同一份配置，且 memory_limit 和 disable_functions 里没禁用 proc_open。否则 composer create-project 会静默失败，连错误都不报。
