在WSL中流畅使用Composer需正确安装PHP（7.4+）和Composer、配置国内镜像（如阿里云）、将项目置于WSL原生路径、启用metadata挂载选项解决权限问题，并通过VS Code集成提升开发体验。

在WSL中使用Composer可以和原生Linux环境一样流畅，关键在于正确安装、配置PHP环境，并解决Windows与Linux路径、权限、网络等常见兼容问题。

安装PHP和Composer

确保已安装PHP（建议7.4或更高版本），再用官方脚本安装Composer：

• 运行 sudo apt update && sudo apt install php-cli unzip
• 下载并安装Composer：curl -sS https://getcomposer.org/installer | php
• 移动到系统路径：sudo mv composer.phar /usr/local/bin/composer
• 验证：composer --version 应显示版本号

配置国内镜像加速（必备）

默认源在国内访问慢且易超时，推荐切换为阿里云或腾讯云镜像：

Handsfree Windows Control

通过 handsfree-windows CLI控制 Windows 本机应用 (UIA) 和浏览器 (Playwright) 的引导技能，用于自动化或测试桌面应用。

下载

• 全局设置阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 验证配置：composer config -g repo.packagist 应返回镜像地址
• 如需临时切回官方源，运行：composer config -g repo.packagist https://packagist.org

处理Windows宿主文件的路径与权限问题

在/mnt/c/等挂载路径下运行Composer可能遇到权限拒绝或符号链接失败。推荐做法：

• 将项目放在WSL原生文件系统中（如~/projects/myapp），而非/mnt/c/Users/xxx/...
• 若必须从Windows路径操作，先启用WSL的metadata选项：编辑/etc/wsl.conf，添加以下内容并重启WSL
• [automount]
  options = "metadata,uid=1000,gid=1000,umask=22,fmask=11"
• 避免在Windows文件系统中使用composer create-project或symlink类命令

集成VS Code与终端工作流

提升开发体验的关键步骤：

• 在WSL中安装VS Code Server：code .（首次运行会自动安装）
• 在VS Code中安装扩展“PHP Intelephense”和“Composer”（by Wengo）增强支持
• 终端中进入项目目录后，直接运行composer install或composer require，输出实时可见
• 如遇zsh: command not found: composer，检查~/.bashrc或~/.zshrc是否已将/usr/local/bin加入PATH