使用Microsoft Fakes的C#测试项目编译报错：未指定extern alias 'snh'

这个问题我之前帮不少开发者排查过，本质是Microsoft Fakes在处理.NET Standard库时，生成假程序集的别名配置出了冲突或者遗漏。咱们一步步来解决：

1. 检查并修复项目文件中的别名关联 #

打开你的测试项目.csproj文件，找到引用abc.dll的节点，确保Aliases属性正确设置，并且和Fakes生成配置关联上：

• 首先确认引用节点的别名配置：

  <Reference Include="abc, Version=X.X.X.X, Culture=neutral, PublicKeyToken=xxx, processorArchitecture=MSIL">
    <Aliases>snh</Aliases>
    <HintPath>..\packages\abc.X.X.X\lib\netstandard2.0\abc.dll</HintPath>
  </Reference>
  

• 然后找到对应的<GenerateFakes>块，保证别名和输出路径匹配：

  <GenerateFakes Include="abc.dll">
    <Aliases>snh</Aliases>
    <OutputPath>Fakes\snh\abc</OutputPath>
  </GenerateFakes>
  

2. 清理旧缓存并重新生成假程序集 #

旧的假程序集缓存很可能是罪魁祸首：

• 先手动删除项目目录下的Fakes文件夹，这是Fakes生成假程序集的默认存放路径；
• 在Visual Studio里，右键测试项目选择「清理解决方案」，之后再右键选择「重新生成」；
• 如果还是不行，右键引用列表里的abc.dll，选择「添加Fakes程序集」，让VS重新生成对应的假程序集和配置文件。

3. 确认测试项目与.NET Standard 2.0的兼容性 #

.NET Standard 2.0需要测试项目的目标框架版本支持：

• 如果是.NET Framework测试项目，目标版本至少要设为4.6.1及以上（4.7.2是更稳妥的选择）；
• 如果是.NET Core/.NET 5+项目，直接支持.NET Standard 2.0，不用额外调整；
• 在.csproj里确认目标框架节点，比如：

  <TargetFramework>net472</TargetFramework>
  

4. 检查Fakes配置文件的正确性 #

项目里如果有abc.fakes配置文件，打开它确认别名设置：

<Fakes xmlns="http://schemas.microsoft.com/fakes/2011/">
  <Assembly Name="abc" Alias="snh"/>
  <!-- 其他自定义配置 -->
</Fakes>

如果没有这个文件，重新添加Fakes程序集会自动生成。

5. 验证Visual Studio版本兼容性 #

老版本的Visual Studio对.NET Standard库的Fakes支持有缺陷，建议使用Visual Studio 2017 Update 5及以后的版本，这些版本对.NET Standard的兼容性更好。

按照上面的步骤一步步排查，基本就能解决这个别名未指定的编译错误了，核心就是保证别名在引用配置、Fakes设置和编译参数里完全一致，同时清理掉旧的缓存文件。

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