如何在Razor视图内创建Tag Helper实现单文件组件效果？

一、通过自定义ITagHelperDescriptorProvider动态注册内嵌Tag Helper #

这种方式直接介入Razor编译流程，让系统识别视图内定义的Tag Helper类：

• 实现ITagHelperDescriptorProvider接口，重写CreateDescriptors方法，在该方法里扫描所有Razor视图文件
• 自定义识别规则，比如用@inlineTagHelper这类自定义指令标记视图内的Tag Helper类代码块，提取后动态编译并生成TagHelperDescriptor注册到系统
• 在项目启动时注册这个自定义提供器：

  services.AddMvc()
          .AddRazorOptions(options =>
          {
              options.TagHelperDescriptorProviders.Add(new InlineTagHelperProvider());
          });
  

  这个方案能真正实现单文件Tag Helper，无需额外后台类，但需要对Razor编译机制有一定了解。

二、用局部视图+动态参数模拟单文件组件体验 #

如果不想折腾编译扩展，这是最轻量化的替代方案：

• 在单个视图文件里，用@functions块定义参数类，或者直接用@model dynamic接收参数
• 编写组件的HTML结构，直接使用模型里的参数
• 调用时通过Html.PartialAsync传递参数，示例：

  @* MyComponent.cshtml *@
  @model dynamic
  <div class="component">
    <h3>@Model.Title</h3>
    <div>@Model.Content</div>
  </div>
  
  @* 调用处 *@
  @await Html.PartialAsync("MyComponent", new { Title = "示例组件", Content = "单文件实现" })
  

  这种方式完全不需要Tag Helper后台类，参数传递灵活，开发体验接近Razor组件。

三、优化现有源代码生成器方案 #

如果之前的生成器方案有问题，可以调整为：

• 将源代码生成器项目直接引用到Web项目，利用.NET 6+的增量编译特性，生成的类直接输出到Web项目的Generated目录
• 确保生成的类带有[TagHelper]特性，Razor编译时会自动扫描识别这些类，无需手动注册ApplicationPart

四、混合Razor组件与Tag Helper的兼容方案 #

其实Razor组件可以和Tag Helper兼容使用，解决你之前的顾虑：

• 在Razor组件中注入IUrlHelper、IHtmlHelper等服务，模拟内置Tag Helper的功能（比如生成链接、表单）
• 封装自定义Tag Helper为静态方法，在组件中直接调用
• 或者在MVC视图中调用Razor组件，组件内部通过Html.Raw渲染Tag Helper生成的HTML

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