WSL2 Ubuntu下Dotnet工具与包安装异常问题求助

核心原因 #

WSL2 Ubuntu环境中存在dotnet可执行文件路径不一致的问题：系统PATH中优先调用的/usr/bin/dotnet与实际执行的宿主路径/usr/share/dotnet/dotnet（你日志中写成/user/share/dotnet/dotnet应为笔误）不匹配，导致全局工具安装、NuGet还原操作实际指向了非预期的dotnet实例，工具被安装到错误目录（甚至可能是root用户的目录），而用户HOME下的.dotnet/tools和.nuget/packages无对应内容。

解决步骤 #

1. 修正dotnet路径优先级，统一执行实例 #

• 查看/usr/bin/dotnet的符号链接指向：

  ls -l /usr/bin/dotnet
  

  正常情况下应指向/usr/share/dotnet/dotnet，如果指向错误或不存在，手动创建符号链接：

  sudo ln -sf /usr/share/dotnet/dotnet /usr/bin/dotnet
  

• 将真正的dotnet安装路径加入PATH最前端，确保优先调用：
  编辑你的shell配置文件（如~/.bashrc或~/.zshrc），添加：

  export PATH="/usr/share/dotnet:$HOME/.dotnet/tools:$PATH"
  

  生效配置：

  source ~/.bashrc
  

• 验证一致性：

  which dotnet  # 应返回 /usr/share/dotnet/dotnet
  dotnet --info  # 查看Host: Path字段，应与上面路径一致
  

2. 清理并重新安装csharp-ls #

• 先卸载所有可能存在的csharp-ls实例（包括root用户下的）：

  dotnet tool uninstall --global csharp-ls
  sudo dotnet tool uninstall --global csharp-ls
  

• 用普通用户重新安装：

  dotnet tool install --global csharp-ls
  

• 检查工具是否出现在预期目录：

  ls $HOME/.dotnet/tools
  

  此时应能看到csharp-ls可执行文件，执行csharp-ls --version验证可用。

3. 修复NuGet全局包路径 #

• 创建或编辑NuGet全局配置文件~/.config/NuGet/NuGet.Config，添加全局包路径配置：

  <configuration>
    <config>
      <add key="globalPackagesFolder" value="/home/你的用户名/.nuget/packages" />
    </config>
    <packageSources>
      <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
    </packageSources>
  </configuration>
  

• 强制重新还原项目：

  dotnet restore --force --verbosity normal
  

• 检查~/.nuget/packages目录，应出现还原的包文件。

4. 验证环境变量永久生效 #

确保以下环境变量已加入shell配置文件（~/.bashrc等）：

export DOTNET_HOST_PATH="/usr/share/dotnet/dotnet"
export PATH="/usr/share/dotnet:$HOME/.dotnet/tools:$PATH"

内容的提问来源于stack exchange，提问作者Riley Hughes