基于.NET 8的PowerShell模块在PowerShell 7.2中运行失败求助

这种情况是正常的，你的预期存在偏差——自包含发布的逻辑不适用于PowerShell模块场景，原因及解决办法如下：

核心原因 #

PowerShell是.NET编写的宿主进程，模块本质是被PowerShell进程加载的.NET程序集，会共享宿主进程的CLR运行时：

• PowerShell 7.2基于.NET 6 runtime，其CLR只能识别加载兼容.NET 6的程序集及依赖；
• 你的模块编译目标是.NET 8，依赖的System.Console 8.0.0.0是.NET 8专属的程序集版本，.NET 6的CLR无法找到并加载它；
• 自包含发布仅针对独立可执行文件（如控制台exe），这类程序会自带完整的.NET runtime，启动时使用自身的CLR；但PowerShell模块是DLL，必须依赖宿主PowerShell的CLR，自包含配置对它无效。

可行解决方案 #

• 多目标框架编译：修改项目文件的TargetFramework为多目标，同时兼容.NET 6和.NET 8：

  <PropertyGroup>
    <TargetFrameworks>net6.0;net8.0</TargetFrameworks>
    <!-- 保留其他原有配置 -->
  </PropertyGroup>
  

  发布时指定对应框架：

  # 生成供PowerShell 7.2使用的版本
  dotnet publish $projectFile --self-contained --configuration Release --output C:\Some\Path\net6.0 -f net6.0
  # 生成供PowerShell 7.4使用的版本
  dotnet publish $projectFile --self-contained --configuration Release --output C:\Some\Path\net8.0 -f net8.0
  

• 使用.NET Standard目标：如果模块代码不依赖.NET 8专属API，可以将目标框架改为.NET Standard 2.1（PowerShell 7.x全版本支持），这样编译出的模块能兼容PowerShell 7.2、7.4等多个版本：

  <PropertyGroup>
    <TargetFramework>netstandard2.1</TargetFramework>
    <!-- 保留其他原有配置 -->
  </PropertyGroup>
  

• 要求用户升级PowerShell：如果模块必须依赖.NET 8的特性，直接要求用户升级到PowerShell 7.4及以上版本，该版本基于.NET 8，可直接加载你的.NET 8模块。

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