c#如何拼接json串

C#中高效拼接JSON字符串的多种方法与实践

在C#开发中，经常需要将数据转换为JSON格式进行传输或存储，虽然现代开发更推荐使用序列化库（如Newtonsoft.Json或System.Text.Json），但在某些简单场景下，直接拼接JSON字符串也是一种可行的选择，本文将介绍几种在C#中拼接JSON字符串的方法，并分析其优缺点及适用场景。

字符串直接拼接法

最简单的方式是使用字符串拼接操作符或字符串插值：

string name = "张三";
int age = 25;
string json = $"{{\"name\":\"{name}\",\"age\":{age}}}";

优点：

直观易懂,无需额外依赖
适用于极简单的JSON结构

缺点：

复杂结构时难以维护
容易出现语法错误（如缺少逗号或引号）
性能较差（频繁字符串拼接）
安全风险（未转义的特殊字符可能导致JSON格式错误）

使用StringBuilder

对于需要拼接较多字符串的场景,可以使用System.Text.StringBuilder提高性能：

var sb = new StringBuilder();
sb.Append("{\"name\":\"");
sb.Append(name);
sb.Append("\",\"age\":");
sb.Append(age);
sb.Append("}");
string json = sb.ToString();

优点：

性能优于直接字符串拼接
适用于中等复杂度的JSON构建

缺点：

代码仍然较为冗长
需要手动处理JSON格式和转义

使用动态对象+序列化

更推荐的方式是先构建动态对象,然后序列化为JSON：

using Newtonsoft.Json;
dynamic person = new System.Dynamic.ExpandoObject();
person.name = "张三";
person.age = 25;
string json = JsonConvert.SerializeObject(person);

或使用匿名对象：

var person = new { name = "张三", age = 25 };
string json = JsonConvert.SerializeObject(person);

优点：

代码简洁可读
自动处理JSON格式和转义
减少人为错误
支持复杂嵌套结构

缺点：

需要引入第三方库（Newtonsoft.Json或System.Text.Json）
简单场景可能显得"杀鸡用牛刀"

使用System.Text.Json（.NET Core 3.0+）

对于.NET Core 3.0及以上版本，可以使用内置的System.Text.Json：

using System.Text.Json;
var person = new { name = "张三", age = 25 };
string json = JsonSerializer.Serialize(person);

优点：

无需额外依赖（.NET Core 3.0+内置）
性能较好
官方支持,持续更新

缺点：

功能相比Newtonsoft.Json略有不足
配置选项不如后者丰富

使用专用JSON构建库

对于需要频繁构建JSON的场景,可以考虑使用专用库如JsonBuilder：

using JsonBuilder;
var json = Json.Object(
    Json.Property("name", "张三"),
    Json.Property("age", 25)
).ToString();

优点：

提供类型安全的构建方式
支持链式调用,代码清晰
自动处理JSON格式规范

缺点：

需要引入额外库
学习成本

最佳实践建议

优先使用序列化方式：对于大多数场景，构建对象后序列化是最佳选择，推荐使用System.Text.Json（.NET Core 3.0+）或Newtonsoft.Json。
简单场景可用字符串插值：对于非常简单的JSON，可以使用字符串插值，但务必注意转义。
避免手动拼接复杂JSON：手动拼接嵌套JSON极易出错，维护成本高。
性能敏感场景测试：如果性能至关重要，应测试不同方法的实际表现。
考虑安全性：手动拼接时要注意防止注入攻击，特别是当数据来自用户输入时。

示例：综合应用

以下是一个结合匿名对象和序列化的完整示例：

using System;
using System.Text.Json;
public class JsonExample
{
    public static void Main()
    {
        var user = new 
        {
            id = 1,
            name = "李四",
            contact = new 
            {
                email = "lisi@example.com",
                phone = "13800138000"
            },
            isActive = true,
            joinDate = DateTime.Now
        };
        string json = JsonSerializer.Serialize(user, new JsonSerializerOptions 
        { 
            WriteIndented = true 
        });
        Console.WriteLine(json);
    }
}

输出结果：

{
  "id": 1,
  "name": "李四",
  "contact": {
    "email": "lisi@example.com",
    "phone": "13800138000"
  },
  "isActive": true,
  "joinDate": "2023-11-15T08:45:30.1234567+08:00"
}

在C#中拼接JSON字符串有多种方法，选择哪种方式应根据具体场景决定，对于生产环境，强烈推荐使用序列化方式，无论是内置的System.Text.Json还是广泛使用的Newtonsoft.Json，它们能提供更好的可维护性、安全性和性能，只有在极简单的场景下，才考虑使用字符串拼接或StringBuilder方式，无论选择哪种方法，都应确保生成的JSON格式正确，数据安全可靠。