ASP.NET Core中如何在渲染时获知Razor页面使用的分部视图？

1. 核心思路：追踪已渲染的分部视图 #

中间件层面无法直接获取视图渲染阶段的分部视图使用情况，因为中间件执行早于视图渲染流程。我们可以通过自定义标签助手+请求级别的追踪服务，在分部视图渲染时记录其路径，再在布局页中根据记录的路径自动引入对应资源。

步骤1：创建视图追踪服务 #

这个服务用于存储当前请求中加载的分部视图路径，注册为Scoped确保每个请求独立：

public class ViewTrackingService
{
    private readonly List<string> _loadedPartials = new();

    public IReadOnlyList<string> LoadedPartials => _loadedPartials.AsReadOnly();

    public void RecordPartial(string viewPath)
    {
        if (!_loadedPartials.Contains(viewPath))
        {
            _loadedPartials.Add(viewPath);
        }
    }
}

在Program.cs中注册：

builder.Services.AddScoped<ViewTrackingService>();

步骤2：自定义分部视图标签助手 #

替换默认的<partial>标签助手，在渲染时记录分部视图路径：

[HtmlTargetElement("partial")]
public class TrackingPartialTagHelper : PartialViewTagHelper
{
    private readonly ViewTrackingService _tracker;

    public TrackingPartialTagHelper(IViewComponentHelper viewComponentHelper, IViewEngine viewEngine, ILoggerFactory loggerFactory, ViewTrackingService tracker) 
        : base(viewComponentHelper, viewEngine, loggerFactory)
    {
        _tracker = tracker;
    }

    public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output)
    {
        if (!string.IsNullOrEmpty(Name))
        {
            _tracker.RecordPartial(Name);
        }
        await base.ProcessAsync(context, output);
    }
}

在_ViewImports.cshtml中注册这个标签助手：

@addTagHelper *, YourProjectNamespace

步骤3：兼容手动调用的分部视图 #

对于用@Html.PartialAsync()手动渲染的分部视图，封装一个扩展方法来记录路径：

public static class HtmlHelperTrackingExtensions
{
    public static async Task<IHtmlContent> TrackedPartialAsync(this IHtmlHelper htmlHelper, string partialViewName)
    {
        var tracker = htmlHelper.ViewContext.HttpContext.RequestServices.GetRequiredService<ViewTrackingService>();
        tracker.RecordPartial(partialViewName);
        return await htmlHelper.PartialAsync(partialViewName);
    }
}

使用时替换为：

@await Html.TrackedPartialAsync("~/Views/Shared/MyPartial.cshtml")

2. 在布局页自动引入资源 #

在布局页注入追踪服务，遍历已记录的分部视图路径，检查对应CSS/JS文件是否存在，自动生成引入标签。

注入追踪服务 #

在布局页顶部添加：

@inject ViewTrackingService ViewTracker

自动引入样式（HTML头部） #

<head>
    <!-- 原有页面自身的样式引入逻辑 -->
    @{
        var currentPagePath = ViewContext.View.Path.TrimStart('/').Replace(".cshtml", "");
        var pageCssPath = $"/{currentPagePath}.css";
        var fullPageCss = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", pageCssPath.TrimStart('/'));
        if (System.IO.File.Exists(fullPageCss))
        {
            <link rel="stylesheet" href="@pageCssPath" />
        }
    }

    <!-- 分部视图样式引入 -->
    @foreach (var partialPath in ViewTracker.LoadedPartials)
    {
        var partialCssPath = $"/{partialPath.Replace(".cshtml", "")}.css";
        var fullPartialCss = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", partialCssPath.TrimStart('/'));
        if (System.IO.File.Exists(fullPartialCss))
        {
            <link rel="stylesheet" href="@partialCssPath" />
        }
    }
</head>

自动引入脚本（Body末尾） #

<body>
    <!-- 页面内容 -->

    <!-- 原有页面自身的脚本引入逻辑 -->
    @{
        var pageJsPath = $"/{currentPagePath}.js";
        var fullPageJs = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", pageJsPath.TrimStart('/'));
        if (System.IO.File.Exists(fullPageJs))
        {
            <script src="@pageJsPath"></script>
        }
    }

    <!-- 分部视图脚本引入 -->
    @foreach (var partialPath in ViewTracker.LoadedPartials)
    {
        var partialJsPath = $"/{partialPath.Replace(".cshtml", "")}.js";
        var fullPartialJs = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", partialJsPath.TrimStart('/'));
        if (System.IO.File.Exists(fullPartialJs))
        {
            <script src="@partialJsPath"></script>
        }
    }
</body>

3. 生产环境优化建议 #

• 缓存文件存在性检查结果，避免每次请求都读取文件系统，可使用内存缓存或分布式缓存。
• 统一分部视图路径格式，避免因相对/绝对路径导致的资源匹配错误。
• 对于大型项目，可结合打包工具（如Webpack）将分部视图的资源合并，减少HTTP请求。

内容的提问来源于stack exchange，提问作者Kelps Leite de Sousa