Microsoft.PowerShell.SDK总是依赖低一版本System.Management.Automation的问题

原因分析 #

1. PowerShell SDK的依赖策略：Microsoft.PowerShell.SDK的每个正式版本会依赖前一个Patch版本的System.Management.Automation（例如7.4.5版本SDK依赖7.4.4版本的Automation程序集），这是PowerShell官方的版本管理逻辑。
2. VS扩展加载上下文限制：进程外VS扩展运行在特殊宿主环境中，默认不会自动应用NuGet生成的程序集绑定重定向规则，导致运行时无法识别高版本Automation可兼容低版本依赖请求，进而抛出文件未找到异常。
3. NuGet包冲突限制：由于SDK已引入更高版本的Automation，NuGet会阻止添加低版本引用以避免冲突，这是正常的包管理机制。

解决办法 #

1. 手动配置程序集绑定重定向 #

在项目的app.config文件中添加绑定重定向规则，强制运行时将旧版本请求指向当前SDK携带的Automation版本：

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="System.Management.Automation"
                          publicKeyToken="31bf3856ad364e35"
                          culture="neutral" />
        <!-- 将0.0.0.0到目标旧版本的请求重定向到当前使用的Automation版本 -->
        <bindingRedirect oldVersion="0.0.0.0-7.4.4.0"
                         newVersion="7.4.5.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

注意：newVersion需替换为你当前SDK对应的System.Management.Automation实际版本，可在NuGet包管理器的已安装列表中查看。

2. 使用PowerShell自包含运行时配置 #

实例化PowerShell时指定使用SDK自带的运行时，绕过宿主环境的程序集解析：

var runtimeConfig = new PowerShellRuntimeConfiguration
{
    RuntimeType = PowerShellRuntimeType.Sdk
};
using (PowerShell powerShell = PowerShell.Create(runtimeConfig, initialSessionState))
{
    // 执行你的PowerShell逻辑
}

3. 项目文件中强制统一版本 #

在.csproj文件中添加全局版本控制，强制所有依赖使用指定版本的System.Management.Automation：

<PropertyGroup>
  <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
</PropertyGroup>
<ItemGroup>
  <PackageVersion Include="System.Management.Automation" Version="7.4.5" />
</ItemGroup>

此配置会覆盖所有依赖项对Automation的版本请求，确保项目仅引用指定的高版本。

4. 验证部署包包含目标程序集 #

确保System.Management.Automation.dll被正确包含在VSIX部署包中：

• 右键项目→属性→生成→输出，确认该程序集的“复制本地”设置为True；
• 构建项目后检查输出目录，确认DLL存在；
• 若为进程外扩展，需确保宿主进程输出目录或扩展部署清单中包含该文件。

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