ASP.NET Core 6 Razor Pages如何通过_ViewStart动态加载同名JS文件

方案1：在布局页通过PageContext动态生成脚本标签 #

直接在主布局文件（如_Layout.cshtml）的</body>前添加以下代码，无需额外依赖，简单直接：

@{
    // 从ActionDescriptor中提取页面名称（剔除Model后缀）
    var pageName = PageContext.ActionDescriptor.DisplayName.Split('.')[^1].Replace("Model", "");
    var jsFilePath = $"~/js/{pageName}.js";
    
    // 检查wwwroot下是否存在对应JS文件，避免404错误
    var webHostEnv = Context.RequestServices.GetRequiredService<IWebHostEnvironment>();
    var fileInfo = webHostEnv.WebRootFileProvider.GetFileInfo(jsFilePath.TrimStart('~', '/'));
    
    if (fileInfo.Exists)
    {
        <script src="@jsFilePath"></script>
    }
}

• 原理：PageContext.ActionDescriptor包含当前渲染页面的完整信息，通过字符串分割提取页面名称
• 优势：无需修改页面Model，零侵入，自动处理不存在的JS文件

方案2：自定义PageModel基类封装逻辑 #

如果需要更灵活的扩展（比如后续添加脚本版本控制、多脚本加载），可以封装到基类中：

1. 创建基类：

using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.AspNetCore.Hosting;

public class BasePage : PageModel
{
    private readonly IWebHostEnvironment _webHostEnv;

    public BasePage(IWebHostEnvironment webHostEnv)
    {
        _webHostEnv = webHostEnv;
    }

    public bool HasMatchingJs { get; private set; }
    public string PageJsPath { get; private set; } = string.Empty;

    public override void OnPageHandlerExecuting(Microsoft.AspNetCore.Mvc.Filters.PageHandlerExecutingContext context)
    {
        base.OnPageHandlerExecuting(context);
        // 从Model类型名称中提取页面名
        var pageName = GetType().Name.Replace("Model", "");
        PageJsPath = $"~/js/{pageName}.js";
        
        // 验证文件存在性
        var fileInfo = _webHostEnv.WebRootFileProvider.GetFileInfo(PageJsPath.TrimStart('~', '/'));
        HasMatchingJs = fileInfo.Exists;
    }
}

2. 让页面Model继承该基类：

public class IndexModel : BasePage
{
    public IndexModel(IWebHostEnvironment webHostEnv) : base(webHostEnv) { }

    public void OnGet() { }
}

3. 在布局页中使用：

@if (Model is BasePage basePage && basePage.HasMatchingJs)
{
    <script src="@basePage.PageJsPath"></script>
}

• 优势：逻辑集中，便于后续扩展，布局页代码更简洁

方案3：自定义Tag Helper实现组件化加载 #

用Tag Helper封装逻辑，布局页只需添加一行标签，符合ASP.NET Core的组件化设计：

1. 创建Tag Helper类：

using Microsoft.AspNetCore.Razor.TagHelpers;
using Microsoft.AspNetCore.Hosting;

[HtmlTargetElement("page-specific-script")]
public class PageSpecificScriptTagHelper : TagHelper
{
    private readonly IWebHostEnvironment _webHostEnv;
    private readonly PageContext _pageContext;

    public PageSpecificScriptTagHelper(IWebHostEnvironment webHostEnv, PageContext pageContext)
    {
        _webHostEnv = webHostEnv;
        _pageContext = pageContext;
    }

    public override void Process(TagHelperContext context, TagHelperOutput output)
    {
        output.TagName = "script";
        // 提取页面名称
        var pageName = _pageContext.ActionDescriptor.DisplayName.Split('.')[^1].Replace("Model", "");
        var jsPath = $"~/js/{pageName}.js";
        
        // 验证文件存在后生成标签，否则不输出
        var fileInfo = _webHostEnv.WebRootFileProvider.GetFileInfo(jsPath.TrimStart('~', '/'));
        if (fileInfo.Exists)
        {
            output.Attributes.SetAttribute("src", jsPath);
        }
        else
        {
            output.SuppressOutput();
        }
    }
}

2. 在_ViewImports.cshtml中注册Tag Helper（替换为你的项目程序集名称）：

@addTagHelper *, YourProjectAssemblyName

3. 在布局页中使用：

<page-specific-script></page-specific-script>

• 优势：完全组件化，布局页代码极简，逻辑可复用、可维护

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