WSL Ubuntu+Docker环境下Laravel执行composer install遇UNC路径错误

错误本质 #

你遇到的问题并非路径中的$符号导致，核心是误在Windows环境执行了composer命令——Windows的CMD不支持\\wsl$这类UNC路径，会自动切换到C:\Windows目录，自然找不到Laravel项目里的composer.json。

解决方案 #

1. 使用WSL内部的Linux绝对路径执行命令

• 打开WSL Ubuntu终端，切换到你的Laravel项目的Linux路径：

  cd /home/你的用户名/laravel-project
  

• 直接在该目录下执行：

  composer install
  

2. 配置WSL终端自动进入项目目录

• 在WSL终端执行以下命令（替换为你的实际项目路径），让终端每次启动自动进入项目目录：

  echo "cd /home/你的用户名/laravel-project" >> ~/.bashrc
  

• 重启WSL终端后，直接执行composer install即可。

3. 确保使用WSL版本的Composer

如果你的composer是Windows版本，即使在WSL里调用也可能触发Windows CMD的路径问题：

• 检查当前composer版本的路径：

  which composer
  

  如果输出是Windows相关路径（比如/mnt/c/ProgramData/ComposerSetup/bin/composer），说明用的是Windows版。
• 在WSL中重新安装Linux版Composer：

  sudo apt update && sudo apt install php-cli unzip
  php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
  php -r "if (hash_file('sha384', 'composer-setup.php') === '756890a4488ce9024fc62c56153228907f1545c228516cbf63f885e036d37e9a59d27d63f46af1d4d07ee0f76181c7d3') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
  php composer-setup.php
  php -r "unlink('composer-setup.php');"
  sudo mv composer.phar /usr/local/bin/composer
  

• 安装完成后，在WSL项目目录执行composer install即可避开Windows路径问题。

4. 映射WSL路径为Windows盘符（可选）

如果需要从Windows侧访问WSL文件，可将WSL路径映射为本地盘符：

• 打开Windows文件资源管理器，右键点击WSL的Ubuntu图标，选择「映射网络驱动器」
• 分配一个盘符（比如Z:），访问路径变为Z:\home\你的用户名\laravel-project
• 注意：执行composer install仍需在WSL终端用Linux路径操作，此方法仅方便Windows侧文件管理。

内容的提问来源于stack exchange，提问作者Jasper Erkel