C# ASP.NET Core调用GitHub API 如何按语言分组定制JSON响应结构

现有代码核心问题 #

• 所有返回值被平铺到同一个List<object>实例中，没有分层存储，最终输出是无业务含义的一维数组
• 循环逻辑内复用同一个数组对象，没有按单个分组/条目创建独立结构对象，导致元素反复堆叠，无法形成嵌套结构
• 无类型/动态类型操作没有做结构化映射，完全无法控制最终JSON的字段层级

落地实现思路 #

首先纠正一点：你之前手写的期望JSON存在语法层面的硬伤——根节点重复定义data键会导致前端读取时只能拿到最后一个分组的数据，数组项后的多余逗号也会触发多数JSON解析器报错。结合你提出的“语言去重、每个语言条目下挂载对应仓库名、仓库计数”的核心需求，结构化输出需要符合JSON通用规范，具体实现分三步：

1. 定义强类型输出DTO，摒弃无类型/动态类型 #

强类型对象可以直接固定输出的JSON结构，避免无类型平铺导致的结构混乱：

// 按语言维度拆分的分组项
public class LanguageTrendGroup
{
    /// <summary>
    /// 编程语言名称，null代表未标记语言的仓库
    /// </summary>
    public string Language { get; set; }
    /// <summary>
    /// 该语言下的仓库总数量
    /// </summary>
    public int RepoCount { get; set; }
    /// <summary>
    /// 该语言下所有仓库的全名称列表
    /// </summary>
    public List<string> RepoFullNames { get; set; }
    /// <summary>
    /// 该语言下所有仓库的访问地址列表
    /// </summary>
    public List<string> RepoUrls { get; set; }
}

/// <summary>
/// 接口最外层返回结构
/// </summary>
public class TrendRepo
{
    public IEnumerable<LanguageTrendGroup> Data { get; set; }
}

2. 提前定义GitHub返回字段的映射类 #

避免用dynamic动态读字段导致的拼写错误、空值报错问题：

public class GithubRepoItem
{
    public int Id { get; set; }
    public string Language { get; set; }
    public string FullName { get; set; }
    public string HtmlUrl { get; set; }
}

3. 用LINQ分组实现语言去重+关联数据挂载 #

核心通过GroupBy按语言字段做分组，自动完成语言去重——同一个语言只会生成一个分组项，组内直接提取所有关联的仓库数据：

// 替换你原有的JToken读取逻辑
var items = JObject.Parse(readerResult)["items"]?.ToObject<List<GithubRepoItem>>() 
            ?? new List<GithubRepoItem>();

// 按语言分组，自动完成语言维度的去重
var groupedTrendData = items
    .GroupBy(repo => repo.Language)
    .Select(group => new LanguageTrendGroup
    {
        Language = group.Key,
        RepoCount = group.Count(),
        RepoFullNames = group.Select(repo => repo.FullName).ToList(),
        RepoUrls = group.Select(repo => repo.HtmlUrl).ToList()
    })
    .ToList();

// 组装最终返回结果
var trendRepo = new TrendRepo
{
    Data = groupedTrendData
};
return new JsonResult(trendRepo);

之前嵌套循环无效的原因 #

你之前尝试嵌套遍历没得到预期效果，本质是所有循环逻辑都在往全局复用的同一个数组里追加元素，没有给每个独立的分组/条目创建对应的结构对象，相当于所有循环的输出全堆在同一个存储位置，自然不会出现结构变化。
如果需要保留原来代码里的分隔符占位符，直接在LanguageTrendGroup类里加对应的属性赋值即可，不要往数组里平铺塞占位字符串，会破坏结构化数据的可解析性。

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