JSON 轉 C#

從 JSON 樣本產生帶序列化 attribute 的 C# class。 使用 namespace 選項把產生的型別歸入你的專案命名空間。預設 輸出針對 Newtonsoft.Json(JsonProperty);相同形狀也能用 於 System.Text.Json——只需替換 attribute 名稱。底層使用 quicktype,完全在你的瀏覽器內運作。

貼上 JSON(或載入範例),即可在右側讀到 C# class。在選項面板設定 namespace,檔案可直接落入你的專案;預設輸出採用 Newtonsoft.Json attribute。

輸入: {"id":42,"name":"devsmiths","createdAt":"2024-03-11T08:24:00Z","stars":1280,"public":true,"contributors":[{"login":"ada","commits":51,"admin":true},{"login":"linus","commits":33,"admin":false}],"homepage":null}

輸出(C#):

using System;
using System.Collections.Generic;
using Newtonsoft.Json;

namespace Devsmiths
{
    public partial class Root
    {
        [JsonProperty("id")] public long Id { get; set; }
        [JsonProperty("name")] public string Name { get; set; }
        [JsonProperty("createdAt")] public string CreatedAt { get; set; }
        [JsonProperty("stars")] public long Stars { get; set; }
        [JsonProperty("public")] public bool Public { get; set; }
        [JsonProperty("contributors")] public Contributor[] Contributors { get; set; }
        [JsonProperty("homepage")] public object Homepage { get; set; }
    }

    public partial class Contributor
    {
        [JsonProperty("login")] public string Login { get; set; }
        [JsonProperty("commits")] public long Commits { get; set; }
        [JsonProperty("admin")] public bool Admin { get; set; }
    }
}

• 預設輸出針對 Newtonsoft.Json(JsonProperty)。 要切到 .NET 6+ 的 System.Text.Json,只需 find/replace:JsonProperty → JsonPropertyName、using Newtonsoft.Json → using System.Text.Json.Serialization——屬性形狀完全相同。
• 屬性是 public 自動屬性(get; set;), 不是 records。C# 9+ records 形狀無法靠原樣通過 System.Text.Json 來回(records 的 primary constructor 需要 [JsonConstructor] 加上排序好的參數)——對語法層產生器超出範圍。
• Nullable reference type 沒有標記。若專案 csproj 開啟 <Nullable>enable</Nullable>,請手動為 reference type 加上 ?(或接受警告)。Value type(long、 bool)會自動以 ? 標示樣本中為 null 的位置。
• 日期字串保持為 string,不是 DateTime / DateTimeOffset。ISO 8601 字串無歧義,但混用序列化 attribute 來處理日期轉換很脆弱——若需要型別化日期, 請寫自訂 JsonConverter。
• 陣列輸出為 T[] 而非 List<T>。 Newtonsoft.Json 與 System.Text.Json 都能正確反序列化兩者; 若 runtime 需要 .Add(),請手動改為 List<T>。
• 單樣本推論:樣本中缺漏的鍵不會自動變 nullable。切換 all optional 套用全部欄位。