ASP.NET 7 C#中换行显示失效问题咨询

核心原因：默认响应序列化行为变更 #

.NET6与.NET7在WebAPI处理string类型返回值时的默认行为存在差异：

• .NET6中，返回string会直接以**纯文本（text/plain）**格式响应，换行符\n/Environment.Newline会被保留并生效。
• .NET7中，默认会将string序列化为JSON字符串（application/json），此时换行符会被转义为\\n，前端或响应查看工具会将其识别为普通字符，而非换行指令。

具体解决方法 #

1. 显式返回纯文本格式 #

如果需要返回纯文本内容，直接使用Content方法指定MIME类型：

[HttpGet]
public IActionResult GetMultilineText()
{
    var text = "第一行\n第二行" + Environment.NewLine + "第三行";
    return Content(text, "text/plain");
}

2. 调整JSON序列化配置（返回JSON对象时） #

如果API返回的是包含多行文本的对象（而非纯字符串），需要修改System.Text.Json的序列化选项，避免换行符被转义：
在Program.cs中添加配置：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 允许宽松的JSON转义，保留换行符
        options.JsonSerializerOptions.Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping;
    });

3. 验证响应原始内容 #

有时候问题出在响应查看工具（比如Swagger UI）的显示逻辑上，而非后端输出。可以用Postman、curl或浏览器的开发者工具查看响应原始文本，确认是否真的包含换行符：

• 使用curl命令测试：

curl http://your-api-url/endpoint

如果原始输出中有换行，说明后端没问题，只需调整前端的文本渲染逻辑（比如在HTML中用<br>替换\n，或设置CSS的white-space: pre-line）。

4. 检查StringBuilder使用（排除代码逻辑问题） #

虽然.NET6和.NET7的StringBuilder.AppendLine行为一致，但仍需确认代码中没有意外修改或转义换行符：

var sb = new StringBuilder();
sb.AppendLine("第一行");
sb.AppendLine("第二行");
var result = sb.ToString();
// 确认result中包含Environment.Newline（Windows下为\r\n，Linux下为\n）

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