WinForms项目添加cshtml文件出现编译错误且无智能提示如何解决

解决方案 #

第一步：替换项目SDK并移除不兼容的Nuget包 #

你当前使用的Microsoft.NET.Sdk默认没有内置Razor工具链，同时安装的2.2版本Microsoft.AspNetCore.Mvc.Core、Microsoft.AspNetCore.Mvc.Razor属于ASP.NET Core 2.x时代的旧包，和.NET 5完全不兼容，是编译报错的核心原因。
打开csproj文件，将第一行修改为：

<Project Sdk="Microsoft.NET.Sdk.Web">

Web SDK不会影响WinForms的正常运行，你原有的OutputType=WinExe、UseWindowsForms=true配置保留即可。之后删除两个旧Mvc包的引用，添加ASP.NET Core框架引用：

<ItemGroup>
  <FrameworkReference Include="Microsoft.AspNetCore.App" />
</ItemGroup>

如果不想修改项目SDK为Web SDK，也可以单独安装Microsoft.NET.Sdk.Razor包补充Razor工具链，兼容性略逊于Web SDK方案。

第二步：修正cshtml文件的生成配置 #

将你原有cshtml相关的配置替换为以下内容：

<PropertyGroup>
  <!-- 适配.NET 5的Razor语言版本 -->
  <RazorLangVersion>3.0</RazorLangVersion>
</PropertyGroup>
<ItemGroup>
  <None Update="Store\Orders\Print\OrdersPrintPageTemplate.cshtml">
    <Generator>RazorTemplatePreprocessor</Generator>
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

第三步：清理缓存验证效果 #

关闭Visual Studio，删除项目根目录的.vs、bin、obj文件夹，重新打开项目执行生成操作，cshtml语法识别、智能提示和编译错误问题就会解决。
如果你使用RazorLight渲染模板，参考以下调用逻辑即可正常渲染：

var razorEngine = new RazorLightEngineBuilder()
    .UseFileSystemProject(Application.StartupPath)
    .UseMemoryCachingProvider()
    .Build();
string html = await razorEngine.CompileRenderAsync("Store\\Orders\\Print\\OrdersPrintPageTemplate.cshtml", 你的Order实例);

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