使用TagBuilder生成HTML却被渲染为纯文本的技术问题求助

核心是Asp.Net Core的Razor视图默认会对输出的字符串进行HTML编码，直接返回string类型的HTML代码会被转义成纯文本，比如<div>会被处理为<div>，最终以文本形式显示。

1. 修改HtmlHelper扩展方法的返回类型（推荐） #

不要返回string，改为返回IHtmlContent类型——TagBuilder本身已经实现了IHtmlContent接口，直接返回实例即可避免编码问题：

原错误写法示例：

public static string Alert(this IHtmlHelper htmlHelper, AlertBox alert)
{
    var div = new TagBuilder("div");
    // 设置样式、内容等逻辑
    return div.ToString();
}

修正后的写法：

public static IHtmlContent Alert(this IHtmlHelper htmlHelper, AlertBox alert)
{
    var alertDiv = new TagBuilder("div");
    // 添加Bootstrap样式类（示例）
    alertDiv.AddCssClass($"alert alert-{alert.Type.ToString().ToLower()}");
    alertDiv.Attributes["role"] = "alert";
    // 添加提示内容，用AppendHtml处理带HTML的内容，Append处理纯文本
    alertDiv.InnerHtml.AppendHtml(alert.Message);

    // 可选：添加关闭按钮
    var closeBtn = new TagBuilder("button");
    closeBtn.AddCssClass("btn-close");
    closeBtn.Attributes["type"] = "button";
    closeBtn.Attributes["data-bs-dismiss"] = "alert";
    alertDiv.InnerHtml.AppendHtml(closeBtn);

    return alertDiv;
}

2. 视图中直接调用扩展方法 #

不需要额外处理，直接输出即可：

@Html.Alert(new AlertBox { Type = AlertType.Success, Message = "操作成功！" })

3. 若必须返回字符串（不推荐） #

如果因特殊需求只能返回字符串，需在视图中用@Html.Raw()包裹，明确告诉Razor不进行HTML编码：

@Html.Raw(Html.Alert(new AlertBox { Type = AlertType.Danger, Message = "操作失败，请重试！" }))

• TagBuilder的ToString()方法默认生成带编码的HTML字符串，直接返回会触发二次编码
• 优先采用返回IHtmlContent的方式，这是Asp.Net Core官方推荐的HTML输出规范
• 区分InnerHtml.AppendHtml()（处理HTML内容）和InnerHtml.Append()（处理纯文本内容）的使用场景

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