在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 应显示版本号
配置国内镜像加速（必备）
- 全局设置阿里云镜像：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
