.NET 5迁移中如何在dotnet/CI流程下生成Microsoft Fakes程序集
问题根因
报错的本质不是NuGet包缺失,是dotnet build默认走的纯CLI构建链路,根本不会触发Microsoft Fakes的程序集生成逻辑。
Microsoft Fakes是Visual Studio Enterprise专属功能,它的生成目标是放在VS安装目录下的专属MSBuild扩展里,默认的dotnet CLI构建上下文不会扫描这些专属路径。哪怕你NuGet源配对了、包也还原下来了,只要没加载对应构建目标、没开生成开关,构建流程会直接跳过所有.fakes配置的编译步骤,自然会报「Fakes命名空间不存在」的错。
你本地之前能正常构建,是Visual Studio IDE会自动加载这些企业版专属目标,dotnet clean清掉IDE之前生成的残留Fakes程序集后,纯CLI构建没有这层加载逻辑,就会稳定复现报错,和你配置了多少个NuGet源没有关系。
可落地的配置调整
替换测试项目的构建执行链路
你现在用的1.x版本.NET Core任务本质就是dotnet CLI的执行包装,靠它根本跑不通Fakes生成流程。直接把测试项目的构建步骤替换为Azure DevOps原生的VSBuild@1任务,这个任务会自动调用构建代理上VS2019 Enterprise的完整MSBuild上下文,自动加载Fakes专属构建目标。
构建参数直接复用你原有的配置即可,注意要去掉原来传给dotnet build的--no-restore参数——VSBuild走的是MSBuild原生还原逻辑,会自动识别你提前通过dotnet restore拉取的依赖,不会重复还原:/p:Configuration=$(BuildConfiguration) /p:VersionPrefix=$(Build.BuildNumber) /p:AssemblyVersion=$(Build.BuildNumber) /p:GenerateProjectSpecificOutputFolder=True替换成VSBuild之后,你原来拆分两次构建的逻辑也可以简化,MSBuild会根据项目引用依赖自动排序构建顺序,不会再出现测试项目先于被测项目构建的问题,能进一步减少流水线的步骤复杂度。
强制开启Fakes生成开关
哪怕用了VSBuild,默认命令行构建场景下Fakes的生成开关是关闭的。直接在对应测试项目的.csproj文件第一个<PropertyGroup>节点下加一行配置,强制打开生成逻辑:<GenerateFakesAssemblies>true</GenerateFakesAssemblies>这个属性在IDE构建时会被自动设为true,命令行构建时默认值为false,这也是你本地纯dotnet build复现失败的核心原因。
移除对本地VS包源的依赖
别把C:\Program Files (x86)\Microsoft SDKs\NuGetPackages\当Fakes包的还原源直接拉包,这个路径是VS本地安装的包缓存,不是正式的NuGet发布源。直接在测试项目里添加nuget.org上的官方包引用,版本匹配VS2019 16.x对.NET 5的适配能力即可:<PackageReference Include="Microsoft.QualityTools.Testing.Fakes" Version="16.11.27" />这样哪怕构建代理的VS缓存路径有差异,也能正常还原依赖,不会因为本地路径找不到包报错。
调整测试执行任务
测试执行环节也别用dotnet test跑带Fakes的测试项目,Fakes生成的shim/stub类型是和VS专属测试引擎绑定的,纯dotnet test链路没有对应的加载权限,会直接报类型初始化失败。把测试步骤替换为VSTest@2任务即可,会自动适配Fakes的运行时加载逻辑。
必查的前置校验项
- 构建代理上的VS2019 Enterprise必须安装「.NET桌面开发」工作负载下的「代码生成和测试工具」组件,这个组件是Fakes的运行时依赖,没装的话不管怎么配构建参数都生成不了Fakes程序集。
- 不要往代码仓库里提交之前IDE自动生成的Fakes产物,避免构建流程因为旧产物出现不可复现的问题。
- 包版本不要选超过16.x的Fakes包,17.x版本是给VS2022适配的,在VS2019的构建上下文下会出现目标文件加载失败。
内容的提问来源于stack exchange,提问作者elliot-j

