多目标项目重命名程序集后条件ProjectReference报错解决咨询

错误原因解析 #

当你将Library.Core的AssemblyName改为Library后，解决方案中出现了项目名称不同但程序集名称相同的两个项目：

• 原Library项目：仅支持net48
• Library.Core项目：仅支持net8.0-windows，但程序集名被改为Library

MSBuild解析项目引用时会优先匹配程序集名称，导致构建net48目标时错误地尝试引用仅支持net8.0-windows的Library.Core项目，从而抛出兼容性错误。

解决方案一：合并为单多目标项目（推荐） #

将原Library和Library.Core的代码合并到一个多目标项目中，从根源上避免同名程序集冲突：

1. 创建或修改一个项目，设置多目标框架：

<TargetFrameworks>net48;net8.0-windows</TargetFrameworks>

2. 迁移原项目代码，用条件编译区分不同框架的专属逻辑：

// net48 专属代码
#if NET48
namespace Library
{
    public class MyNet48Class { }
}
#endif

// net8.0-windows 专属代码
#if NET8_0_WINDOWS
namespace Library
{
    public class MyNet8Class { }
}
#endif

3. 删除原Library和Library.Core项目，更新MultiTargetLibrary1中的引用，直接指向这个新的多目标项目，无需条件引用：

<ProjectReference Include="..\MultiTargetLibrary\MultiTargetLibrary.csproj" />

4. XAML中只需保留统一的命名空间引用：

xmlns:custom="clr-namespace:Library;assembly=Library"

解决方案二：保留双项目，用XAML条件编译切换命名空间 #

不修改程序集名称，通过XAML的条件编译自动切换引用的命名空间：

1. 恢复Library.Core的AssemblyName为Library.Core
2. 在MultiTargetDemo2的csproj中添加框架专属的编译常量：

<PropertyGroup>
  <DefineConstants Condition="'$(TargetFramework)' == 'net48'">NET48;$(DefineConstants)</DefineConstants>
  <DefineConstants Condition="'$(TargetFramework)' == 'net8.0-windows'">NET8_0_WINDOWS;$(DefineConstants)</DefineConstants>
</PropertyGroup>

3. 在XAML文件中使用条件编译切换命名空间：

#if NET48
xmlns:custom="clr-namespace:Library;assembly=Library"
#endif
#if NET8_0_WINDOWS
xmlns:custom="clr-namespace:Library;assembly=Library.Core"
#endif

解决方案三：保留同名程序集，用项目GUID明确引用路径 #

如果坚持要保留Library.Core的程序集名为Library，可以通过项目GUID强制指定引用的项目，避免MSBuild混淆：

1. 从Library和Library.Core的csproj文件中复制各自的<ProjectGuid>值
2. 修改MultiTargetLibrary1的csproj中的条件引用，明确指定项目GUID：

<!-- net48 引用原Library项目 -->
<ProjectReference Include="..\Library\Library.csproj" Condition="'$(TargetFramework)' == 'net48'">
  <Project>{Library项目的GUID}</Project>
  <Name>Library</Name>
</ProjectReference>

<!-- net8.0-windows 引用Library.Core项目 -->
<ProjectReference Include="..\Library.Core\Library.Core.csproj" Condition="'$(TargetFramework)' != 'net48'">
  <Project>{Library.Core项目的GUID}</Project>
  <Name>Library</Name>
</ProjectReference>

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