.NET5 ASP.NET MVC中引用类库项目的Razor页面修改无需重启主项目实时生效的实现方法

我完全懂你的困扰——每次改完类库的Razor页面都要重启主项目，这折腾起来真的太耗时间了。默认的AddRazorRuntimeCompilation()只会监听主项目的文件变化，不会自动扫描引用的类库文件，所以咱们得调整下配置，把类库的Razor文件目录纳入实时编译的监听范围。下面是具体解决步骤：

1. 先把类库项目的配置调对 #

打开你的共享UI类库项目的.csproj文件，添加以下配置，确保Razor页面能被正确识别和处理：

<PropertyGroup>
  <!-- 启用MVC的Razor支持 -->
  <AddRazorSupportForMvc>true</AddRazorSupportForMvc>
  <!-- 开发环境保留编译上下文，方便实时编译 -->
  <PreserveCompilationContext>true</PreserveCompilationContext>
</PropertyGroup>

<ItemGroup>
  <!-- 确保Razor页面被标记为内容文件，编译时复制到输出目录 -->
  <Content Include="**/*.cshtml">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

2. 修改主项目的实时编译配置 #

在主项目的Startup.cs（如果用.NET5顶级语句就是Program.cs）里，扩展AddRazorRuntimeCompilation的配置，手动把类库的文件路径加进去：

using Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation;
using System.IO;

// ...

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllersWithViews()
        .AddRazorRuntimeCompilation(options =>
        {
            // 只在开发环境启用，避免影响生产环境性能
            if (env.IsDevelopment())
            {
                // 替换成你的类库项目路径，这里假设类库和主项目在同一解决方案根目录下
                var sharedUiPath = Path.Combine(Directory.GetCurrentDirectory(), "../SharedUI");
                options.FileProviders.Add(new PhysicalFileProvider(sharedUiPath));
            }
        });
}

核心就是通过PhysicalFileProvider把类库的根目录加入到实时编译的文件提供者列表里，这样编译器就能监听到类库中.cshtml文件的变化了。

3. 验证效果 #

完成以上配置后，重启一次主项目（这是最后一次需要手动重启）。之后你修改类库中的任何.cshtml文件，保存后直接刷新浏览器，就能看到实时更新的效果了。

小提醒 #

• 路径要准确：如果你的类库和主项目的目录结构不一样，要调整sharedUiPath的相对路径，确保能正确指向类库的根目录。
• NuGet包确认：主项目要确保已经安装了Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation包（.NET5创建MVC项目时默认会包含，但若手动添加的话需要检查）。

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