Go语言中将结构体以标准JSON格式输出到控制台的完整教程

本文介绍如何在go中将结构体序列化为标准json字符串并输出到终端，避免手动拼接键名，确保类型（如数组、布尔值、嵌套结构等）被正确保留。

在Go语言中，将结构体原生、准确地转换为JSON格式并输出（例如用于CLI工具、与Rails等外部系统集成），无需手动构造字符串——核心依赖标准库 encoding/json 包提供的 json.Encoder 或 json.Marshal。相比 fmt.Printf("%+v", s) 仅输出Go风格的调试表示（无引号、无双引号包裹字符串、不区分null/nil、不支持自定义字段名），JSON序列化能严格遵循RFC 8259规范：自动添加双引号、转义特殊字符、保留数组方括号 []、对象花括号 {}、布尔字面量 true/false、null 表示零值指针或接口，且支持通过结构体标签（json:"field_name"）精确控制键名与序列化行为。

以下是一个生产就绪的示例，展示如何安全、可扩展地输出结构体为JSON：

package main

import (
    "encoding/json"
    "fmt"
    "log"
    "os"
)

// 示例结构体：包含字符串、整数、布尔值、切片和嵌套结构
type User struct {
    Name     string   `json:"name"`
    Age      int      `json:"age"`
    Active   bool     `json:"active"`
    Tags     []string `json:"tags"`
    Metadata map[string]interface{} `json:"metadata"`
}

func main() {
    user := User{
        Name:   "Alice",
        Age:    30,
        Active: true,
        Tags:   []string{"developer", "golang"},
        Metadata: map[string]interface{}{
            "score": 95.5,
            "roles": []string{"admin", "user"},
        },
    }

    // ✅ 推荐方式：使用 json.NewEncoder(os.Stdout).Encode()
    // 自动换行，高效流式输出，适合命令行工具
    if err := json.NewEncoder(os.Stdout).Encode(user); err != nil {
        log.Fatalf("JSON encoding failed: %v", err)
    }

    // ? 替代方式：先 Marshal 再 Print（适用于需进一步处理JSON字符串的场景）
    // jsonData, err := json.Marshal(user)
    // if err != nil {
    //     log.Fatal(err)
    // }
    // fmt.Println(string(jsonData))
}

运行后输出（格式化为单行，符合JSON标准）：

{"name":"Alice","age":30,"ac
tive":true,"tags":["developer","golang"],"metadata":{"roles":["admin","user"],"score":95.5}}

⚠️ 注意事项：

• 字段导出性：Go中只有首字母大写的字段（即导出字段）才能被 json 包访问；小写字段将被忽略。
• 空值处理：零值字段（如空字符串、0、false）默认仍会输出。如需跳过，可添加 ,omitempty 标签：Name stringjson:"name,omitempty"`。
• 时间与自定义类型：time.Time 需配合 json.Marshal 的自定义方法或使用 MarshalJSON()；自定义类型建议实现 json.Marshaler 接口。
• 错误处理不可省略：json.Encode 和 json.Marshal 均可能返回错误（如循环引用、不支持类型），务必检查。
• 与Rails集成提示：若作为Rails服务器的子进程调用（如 system("go-run-json-tool")），确保Go程序仅输出纯净JSON（无额外日志、空行），并设置 os.Stdout 为未缓冲（通常默认满足），避免输出延迟。

总结：json.NewEncoder(os.Stdout).Encode(v) 是最简洁、健壮、符合Unix哲学（“只做一件事，并做好”）的方式——它将任意可序列化的Go值直接、无损、标准化地输出为JSON流，完美适配脚本化调用与跨语言数据交换场景。