多目标框架下引用跨平台类库遇CS0006、NETSDK1005错误求解

问题根源 #

你的错误源于.NET Framework的**Windows特定目标框架（net481-windows）与类库的标准跨平台目标框架（net481）**之间的引用解析不匹配：

• 编译程序的net481-windows目标时，MSBuild会尝试查找类库中对应net481-windows版本的输出，但类库仅提供net481版本，导致CS0009（元文件未找到）；
• 手动复制文件后，project.assets.json中没有net481-windows的依赖记录，触发NETSDK1005错误。

稳定可行的解决方案 #

无需修改类库的跨平台特性，只需在程序项目中显式指定类库的目标框架映射，让net481-windows目标引用类库的net481版本（两者完全兼容，因为net481-windows本质是net481添加Windows特定组件）。

修改程序项目的.csproj #

将原有的ProjectReference节点替换为以下内容：

<ItemGroup>
  <ProjectReference Include="..\TestProjLib\TestProjLib.csproj">
    <!-- 为net481-windows目标指定引用类库的net481版本 -->
    <SetTargetFramework Condition="'$(TargetFramework)' == 'net481-windows'">TargetFramework=net481</SetTargetFramework>
  </ProjectReference>
</ItemGroup>

原理说明 #

• SetTargetFramework属性强制MSBuild在编译程序的net481-windows目标时，使用类库的net481输出；
• 对于net9.0-windows目标，MSBuild会自动匹配类库的net9.0版本（.NET 5+的Windows TFM与标准TFM的兼容性解析更完善）；
• 类库保持net481;net9.0的跨平台配置，不会失去跨平台特性。

替代方案（可选） #

如果你的WinForms/WPF程序在.NET Framework下不需要依赖Windows特定的SDK扩展，也可以将程序的TargetFrameworks修改为：

<TargetFrameworks>net481;net9.0-windows</TargetFrameworks>

这样程序的.NET Framework目标直接使用标准net481，与类库的目标框架完全匹配，无需额外配置。但此方案仅适用于程序未使用net481-windows特有的API（如WPF的某些Windows专属控件）的场景。

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