JSON 轉 Go

相關推薦

關於 JSON 轉 Go：把 JSON 變成 Go 的強類型 struct

適用場景

• Go 後端開發把 REST API 回應 JSON 轉成 struct，直接用 json.Unmarshal 綁定到 Gin/Echo/Fiber handler 的入參
• 前後端聯調時拿到 Postman 裡的範例回應 JSON，快速生成 Go model 減少手寫欄位
• 對接第三方 Webhook 回呼時，把 payload JSON 轉成 Go struct 方便欄位級存取與校驗
• 把 Viper/Consul/Nacos 裡的 JSON 設定檔轉成 Go 類型，替代 map[string]interface{} 的弱類型存取
• 微服務團隊統一定義 gRPC/HTTP 介面的請求回應結構，把範例 JSON 轉成共享的 Go 類型
• 測試工程師把 JSON fixture 轉成 Go struct，配合 testify 做斷言驅動測試
• 維運人員解析 ELK/Fluentd 收集的 JSON 日誌行，生成 struct 後用 Go 程式做結構化分析
• 爬蟲抓取到 JSON 資料後轉成 Go struct，配合 gorm/gen 或 ent 生成資料庫模型
• IoT 裝置上報的 JSON 遙測資料轉成 Go struct，在邊緣閘道程式中做反序列化與過濾
• 把 Kafka/NATS/RabbitMQ 消費的 JSON 訊息轉成 Go 類型，用於事件驅動的消費者實現
• SDK 開發者把服務端範例回應 JSON 轉成 Go struct，寫入 client 庫的 types 套件供使用者引用
• 把 Swagger/OpenAPI 文件中的範例 JSON 轉成 Go struct，作為介面文件程式碼範例
• 學生或講師在 Go 課程中把範例 JSON 轉成 struct，示範 Go 的類型系統與 json 標籤用法
• 資料移轉指令碼把 MySQL/PostgreSQL 匯出的 JSON 行轉成 Go struct，做欄位映射與類型校驗
• CI/CD 設定 JSON 轉 Go struct，方便在 Go 編寫的流水線工具裡強類型讀取設定
• 老專案中把基於 map 動態讀取的 JSON 程式碼重構為基於 struct 的強類型存取

使用方法

1. 在左側編輯器貼上 JSON 內容，或拖曳上傳 .json/.txt 檔案，也可以點擊「範例」載入內建資料。
2. 等待約 400ms，工具會自動轉換並在右側顯示生成的 Go struct 程式碼。
3. 如果 JSON 報錯，點擊「修復 JSON」按鈕自動修正常見格式錯誤後繼續生成。
4. 檢查右側輸出，點擊「複製」貼到 Go 專案，或點擊「下載」儲存為 model.go 檔案。

功能特點

• 瀏覽器本機生成 Go struct：JSON 解析與 Go 程式碼生成在瀏覽器內完成，原始資料不上傳伺服器
• 400ms 防抖自動轉換：貼上或修改後無需手動點擊，右側即時輸出可複製的 Go 程式碼
• 智慧型別推斷：字串映射為 string、布林映射為 bool、整數映射為 int64、浮點映射為 float64、陣列映射為切片、物件映射為 struct
• 巢狀物件自動展開：遞迴生成獨立 struct 類型，保持 JSON 層級關係清晰
• 自動生成 json 標籤：欄位後附帶 `json:"原始欄位名"` 標籤，可直接配合 encoding/json 使用
• JSON 錯誤一鍵修復：自動處理尾隨逗號、單引號、缺引號等常見格式錯誤，修復後繼續生成
• 支援貼上/上傳/範例三種輸入：可拖曳上傳 .json/.txt 檔案，或載入內建中文範例
• 一鍵複製與下載：複製整段 Go 程式碼到剪貼簿，或下載為 model.go 檔案直接放入專案
• localStorage 輸入歷史：自動儲存最近輸入，重新整理或誤關頁面後可快速恢復
• 響應式分屏編輯器：左右面板寬度可調，桌面和移動端都能舒適檢視輸入與輸出

程式碼範例

package main

import (
    "encoding/json"
    "fmt"
)

// 以下代码由 GeekFormat JSON 转 Go 工具生成
type User struct {
    ID      int64    `json:"id"`
    Name    string   `json:"name"`
    Tags    []string `json:"tags"`
    Address Address  `json:"address"`
}

type Address struct {
    City string `json:"city"`
}

func main() {
    data := []byte(`{
        "id": 1,
        "name": "Alice",
        "tags": ["admin", "dev"],
        "address": {"city": "Beijing"}
    }`)

    var u User
    if err := json.Unmarshal(data, &u); err != nil {
        panic(err)
    }

    fmt.Println(u.Name, u.Address.City)
}

package main

import "encoding/json"

// 手动将字段改为指针，缺失时值为 nil
type User struct {
    ID      *int64  `json:"id,omitempty"`
    Name    *string `json:"name,omitempty"`
    Email   *string `json:"email,omitempty"`
}

func main() {
    data := []byte(`{"id": 1, "name": "Bob"}`)
    var u User
    json.Unmarshal(data, &u)
    if u.Email == nil {
        println("Email 字段缺失")
    }
}

常見問題

故障排查

術語表

struct

Go 的複合資料類型，用於把多個欄位組合成一個類型。本工具生成的 Go 程式碼主體就是若干 struct 定義。

slice

Go 的動態陣列類型，語法為 []T。本工具會把 JSON 陣列映射為對應的 slice，例如 []string、[]int64、[]UserItem。

json tag

Go struct 欄位後的反引號字串，如 `json:"user_name"`，用於指定 encoding/json 序列化/反序列化時的欄位名。本工具會自動生成該標籤。

interface{}

Go 的空介面類型，可以表示任意值。本工具在遇到 JSON null 或類型無法確定時，會用 interface{} 作為安全兜底。

PascalCase

每個單字首字母大寫的命名風格，如 UserName、AddressCity。Go 要求可匯出欄位必須以大寫字母開頭，因此本工具會自動把 JSON 欄位名轉為 PascalCase。

encoding/json

Go 標準庫中的 JSON 編解碼套件。本工具生成的 struct 配合 json 標籤後，可直接用 json.Unmarshal 和 json.Marshal 處理。

unmarshal

把 JSON 位元組流解析為 Go 值的過程。生成 struct 後，最常見的用法就是呼叫 json.Unmarshal(data, &user)。

omitempty

Go json tag 的常用選項，如 `json:"name,omitempty"`，表示欄位為零值時省略輸出。本工具預設不生成 omitempty，可在生成後按需手動新增。

JSON 類型到 Go 類型映射速查表

本工具根據 JSON 值的類型自動推斷對應的 Go 類型，常見映射關係如下：

常見 Go 數字類型選擇建議

工具預設使用 int64 和 float64，實際專案中可按需求調整：

Privacy & Security

本 JSON 轉 Go 工具的所有處理完全在你的瀏覽器本機完成：JSON 解析、類型推斷、Go 程式碼生成全部透過 Web Worker 在用戶端執行，輸入的 JSON 內容、上傳的檔案以及生成的 Go 程式碼都不會上傳到任何伺服器，也不會被記錄、快取或儲存到雲端。關閉或重新整理頁面後，所有輸入和輸出內容自動從記憶體清除，僅 localStorage 會保留你最近輸入的歷史記錄（可隨時清空）。適合處理含 API 金鑰、token、敏感業務資料的 JSON。