ASP.NET Core 5 同目录Partial View无法渲染 三种调用写法均失效

问题原因与解决方案 #

标签被原样输出的核心原因是Razor引擎没有将其识别为标签辅助器（Tag Helper），仅当做普通HTML文本处理，可按以下步骤逐一排查解决：

• 第一步：检查_ViewImports.cshtml的Tag Helper注册
  确保你的项目Views目录下的_ViewImports.cshtml文件中存在以下注册语句，缺失该语句会导致所有内置Tag Helper失效：

  @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
  

  若你的分部视图存放在Area目录下，也需要同步在Area对应Views目录的_ViewImports.cshtml中添加上述注册代码。

• 第二步：兼容低版本框架的替代写法
  标签辅助器仅支持ASP.NET Core 2.1及以上版本，若你的项目目标框架版本更低，或者不想依赖Tag Helper，可以直接改用Razor Html辅助器语法，兼容性更强：

  @await Html.PartialAsync("_BusinessBaseRatesPartial")
  

• 第三步：排查文件配置冲突

  • 确认主视图和分部视图的扩展名均为.cshtml，非.cshtml文件不会触发Razor解析
  • 检查项目是否存在自定义的同名partial标签辅助器，若存在冲突可直接使用上述Html辅助器写法规避

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