将带类型约束的Razor组件移至独立类库时出现语法错误

将带类型约束参数的共享Razor组件迁移到独立Razor类库（RCL）后，出现错误提示且语法高亮失效，此前组件运行正常。目标框架为.NET 7.0，使用最新版Visual Studio 2022。

错误提示为：

Unexpected literal following the 'typeparam' directive. Expected 'line break'

错误表现具有间歇性，偶尔会自行消失、语法高亮恢复，但之后会再次出现。

组件代码示例 #

TestComponent.razor #

@using DDP.Core.Lib.Models;
@using DDP.Core.Lib.Services;
@typeparam T where T : BaseModel;
@typeparam TA where TA : BaseAuditModel;

<InputText @bind-Value="TestInput" />

TestComponent.razor.cs #

using DDP.Core.Lib.Models;
using Microsoft.AspNetCore.Components;

namespace DDP.Core.Razor
{
    public partial class TestComponent<T,TA> : ComponentBase
        where T : BaseModel
        where TA : BaseAuditModel
    {
        protected string TestInput { get; set; } = "";
    }
}

解决方法 #

• 修正Razor文件中的@typeparam语法：移除@typeparam指令末尾的分号，Razor解析器不允许在类型约束后添加分号，这是导致错误的直接原因。修正后的代码如下：

  @using DDP.Core.Lib.Models;
  @using DDP.Core.Lib.Services;
  @typeparam T where T : BaseModel
  @typeparam TA where TA : BaseAuditModel
  
  <InputText @bind-Value="TestInput" />
  

• 确保项目环境配置正确：确认RCL项目的目标框架为.NET 7.0，且Visual Studio 2022已安装最新的.NET 7.0 SDK及ASP.NET Core工作负载。

• 处理间歇性问题：若错误仍偶尔出现，可尝试：

  • 清理项目的bin和obj目录，重新生成解决方案
  • 重置Visual Studio组件缓存（通过开发者命令提示符执行devenv /resetuserdata，操作前请备份个人配置）
  • 将Visual Studio更新至最新版本，确保Razor工具链的相关补丁已安装

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