如何正确引用Shared/Components子文件夹下的View Component？

核心修复步骤 #

针对你遇到的子文件夹下View Component无法被正确识别的问题，可按以下方案排查解决：

• 确保命名空间与文件夹层级匹配
  位于Shared/Components/UserCRUD/{MyComponent}的组件类，命名空间必须包含UserCRUD层级，示例代码：

  namespace YourProjectName.Shared.Components.UserCRUD
  {
      public class MyComponent : ViewComponent
      {
          // 组件业务逻辑
      }
  }
  

  命名空间不匹配会导致框架无法关联到子文件夹路径。

• 使用完整组件标识引用
  在Razor页面中引用时，需明确指定包含子文件夹的组件标识，而非仅类名：

  @* 方式1：使用带路径的组件名称 *@
  @await Component.InvokeAsync("UserCRUD.MyComponent")
  
  @* 方式2：使用typeof指定完整类型 *@
  @await Component.InvokeAsync(typeof(YourProjectName.Shared.Components.UserCRUD.MyComponent))
  

• 显式声明组件名称（可选）
  如果组件类名与文件夹结构存在差异，可通过ViewComponent特性强制声明组件的完整标识：

  [ViewComponent(Name = "UserCRUD.MyComponent")]
  public class MyComponent : ViewComponent
  {
      // 组件业务逻辑
  }
  

• 校验视图文件路径
  确保组件的视图文件严格遵循路径规则：Shared/Components/UserCRUD/MyComponent/Default.cshtml（或自定义视图名），视图文件的父文件夹必须与组件类的逻辑路径对应。

问题原因说明 #

Razor View Component默认仅在Shared/Components根目录下搜索组件，若使用子文件夹结构，必须通过命名空间关联或显式指定完整组件名称告知框架正确的查找路径，否则会忽略子文件夹层级，导致找不到目标组件。

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