无对应.NET类时，大型JSON字符串属性名修改的高效方法问询

针对你这种大体积动态JSON的字段重命名需求，最高效的方案绝对是流式JSON处理——完全不需要把整个JSON加载到内存反序列化为对象，而是逐节点读取并修改，内存占用极低，性能拉满。

我推荐用.NET原生的Utf8JsonReader和Utf8JsonWriter来实现，这两个API是专门为高性能JSON处理设计的，尤其适合大数据量场景。下面是完整的实现思路和代码：

核心思路 #

我们要跟踪JSON的上下文，精准定位需要修改的字段：

1. 当读取到名为profiles的属性时，标记接下来的数组是我们要处理的目标数组
2. 进入profiles数组后，里面的每个对象都是profile对象，此时如果遇到name属性，就把它替换成profileName
3. 其他所有节点都原样写入输出，确保JSON结构完全保留

完整代码实现 #

using System.Text.Json;
using System.Text;

public static async Task TransformProfileNamesAsync(Stream inputStream, Stream outputStream)
{
    // 配置读写器选项，按需调整
    var readerOptions = new JsonReaderOptions
    {
        AllowTrailingCommas = true,
        CommentHandling = JsonCommentHandling.Skip,
        MaxDepth = 64 // 根据你的JSON实际深度调整，默认64足够大部分场景
    };

    var writerOptions = new JsonWriterOptions
    {
        Indented = false, // 大文件建议关闭缩进减少体积，需要格式化的话可以设为true
        SkipValidation = false
    };

    using var reader = new Utf8JsonReader(inputStream, readerOptions);
    using var writer = new Utf8JsonWriter(outputStream, writerOptions);

    bool isInProfilesArray = false;
    bool isInsideProfileObject = false;

    while (reader.Read())
    {
        switch (reader.TokenType)
        {
            case JsonTokenType.PropertyName:
                string propName = reader.GetString()!;
                if (propName.Equals("profiles", StringComparison.Ordinal))
                {
                    writer.WritePropertyName(propName);
                    isInProfilesArray = true; // 标记接下来的数组是profiles数组
                }
                else if (isInsideProfileObject && propName.Equals("name", StringComparison.Ordinal))
                {
                    writer.WritePropertyName("profileName"); // 替换属性名
                }
                else
                {
                    writer.WritePropertyName(propName); // 其他属性原样写入
                }
                break;

            case JsonTokenType.StartArray:
                writer.WriteStartArray();
                break;

            case JsonTokenType.EndArray:
                writer.WriteEndArray();
                if (isInProfilesArray)
                {
                    isInProfilesArray = false; // 退出profiles数组，取消标记
                }
                break;

            case JsonTokenType.StartObject:
                writer.WriteStartObject();
                if (isInProfilesArray)
                {
                    isInsideProfileObject = true; // 进入profile对象，标记上下文
                }
                break;

            case JsonTokenType.EndObject:
                writer.WriteEndObject();
                if (isInsideProfileObject)
                {
                    isInsideProfileObject = false; // 退出profile对象，取消标记
                }
                break;

            // 所有基础类型（字符串、数字、布尔、null等）直接原样写入
            default:
                writer.WriteTokenValue(reader);
                break;
        }
    }
}

使用示例 #

处理文件（适合大JSON）

using var input = File.OpenRead("large-input.json");
using var output = File.OpenWrite("modified-output.json");
await TransformProfileNamesAsync(input, output);

处理字符串（小JSON测试用）

string originalJson = "[ { \"name\": \"name 1\", \"profiles\":[{ \"name\": \"profile 1.1\" },{ \"name\": \"profile 1.2\" }] },{ \"name\": \"name 2\", \"profiles\":[{ \"name\": \"profile 2.1\" }] } ]";
using var inputStream = new MemoryStream(Encoding.UTF8.GetBytes(originalJson));
using var outputStream = new MemoryStream();

await TransformProfileNamesAsync(inputStream, outputStream);
string modifiedJson = Encoding.UTF8.GetString(outputStream.ToArray());
Console.WriteLine(modifiedJson);

为什么这个方案高效？ #

• 流式处理：全程只处理当前节点，内存占用仅取决于JSON的最大深度，而不是整个JSON的大小，GB级别的文件也能轻松处理。
• 原生高性能：Utf8JsonReader/Utf8JsonWriter是.NET团队优化过的底层API，比反序列化为Dictionary<string, object>这种树形结构快数倍，也比第三方库的流式处理更可靠。
• 动态适配：不管JSON有多少额外字段或嵌套层级，只要是profiles数组内对象的name属性都会被替换，完全不需要定义任何实体类。

兼容.NET Framework的替代方案 #

如果你还在使用.NET Framework（而非.NET Core/.NET 5+），可以用Newtonsoft.Json的JsonReader和JsonWriter实现相同逻辑，核心思路完全一致，只是API略有不同。

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