Win10 WSL(Ubuntu)中.NET Core SDK异常致Q#运行报错求助

这种情况确实挺让人挠头的——编译顺利通过，一运行就卡在Microsoft.Quantum.*方法的动态库加载上，甚至重装WSL镜像都没解决，说明问题大概率不在常规的镜像文件层面，得从环境配置、组件完整性这些方向逐一排查。

排查与修复步骤 #

• 验证.NET SDK与Q#组件的版本一致性
  首先确认这台设备的.NET Core SDK版本和另外两台完全匹配，运行以下命令查看详细信息：

  dotnet --info
  

  同时在项目目录下检查Q#相关依赖包的版本：

  dotnet list package
  

  如果版本和正常设备不一致，建议卸载现有SDK，重新安装完全相同的版本——版本不兼容是动态库找不到的常见诱因。

• 检查动态库加载路径配置
  动态库加载失败很多时候和LD_LIBRARY_PATH环境变量有关，先对比正常设备的路径配置：

  echo $LD_LIBRARY_PATH
  

  如果第三台设备缺少.NET或Q#相关的库路径，可以手动添加，比如：

  export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/share/dotnet/shared/Microsoft.NETCore.App/<你的SDK版本号>
  

  把这条命令加到~/.bashrc或~/.zshrc里，确保每次启动WSL都能自动加载正确的路径。

• 手动确认Q#原生库是否存在
  直接去.NET安装目录查找Q#相关的原生库文件，比如：

  ls /usr/share/dotnet/shared/Microsoft.Quantum.Simulator/
  

  或者检查用户本地工具目录：

  ls ~/.dotnet/tools/.store/microsoft.quantum.sdk/
  

  如果发现缺失关键的.so文件（比如libMicrosoft.Quantum.Simulator.so），可以尝试手动下载对应版本的Q# SDK包，解压后把库文件放到正确路径。

• 检查WSL版本兼容性
  WSL1和WSL2的系统调用、文件交互逻辑差异很大，先确认第三台设备的WSL版本：

  wsl --list --verbose
  

  如果和另外两台版本不同（比如另外两台是WSL2，这台是WSL1），尝试切换版本：

  wsl --set-version Ubuntu 2
  

  切换完成后重启WSL再测试。

• 用极简项目隔离问题
  创建一个全新的空白Q#项目，排除原有项目的配置干扰：

  mkdir test-qsharp && cd test-qsharp
  dotnet new console -lang Q#
  dotnet run
  

  如果这个极简项目也报错，说明是全局环境的问题；如果能正常运行，就要回头检查原有项目的.csproj配置或依赖是否有异常。

• 排查Windows主机环境的潜在影响
  虽然WSL是独立环境，但偶尔会和Windows主机的.NET环境产生交互。可以在Windows主机上打开管理员命令提示符，修复.NET SDK：

  dotnet tool repair
  

  修复完成后重启WSL，再测试Q#项目的运行情况。

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