本文介绍如何在 go 程序中将结构体（含字段名、值及原始类型，如数组、布尔值、嵌套结构等）准确序列化为标准 json 字符串，并直接输出到终端或管道，适用于 cli 工具、与 rails 等外部系统集成等场景。
在 Go 中，将结构体转换为符合 RFC 8259 规范的 JSON 字符串并输出，不应依赖 fmt.Printf 或 fmt.Println 的默认格式化（如 %+v）——它们输出的是 Go 语法风格的调试表示，不含双引号、无转义、不区分字符串与数字类型，且无法处理嵌套、切片、指针等复杂结构。
正确的方式是使用标准库 encoding/json 包提供的 json.Encoder（推荐用于流式输出，如 os.Stdout）或 json.Marshal（适用于需进一步处理 JSON 字节流的场景）。
✅ 推荐做法：使用 json.NewEncoder(os.Stdout).Encode()
该方法安全、高效、自动处理类型映射（string → "string"，int → 123，[]string → ["a","b"]，nil → null），并确保输出合法 JSON（含换行符，符合 JSON 文本规范）：
package main
import (
"encoding/json"
"log"
"os"
)
func main() {
// 示例结构体（支持导出字段、嵌套、切片、布尔值等）
data := struct {
Name string `json:"name"`
Age int `json:"age"`
Tags []string `json:"tags"`
Active bool `json:"active"`
Metadata map[string]interface{} `json:"metadata"`
}{
Name: "Alice",
Age: 30,
Tags: []string{"golang", "json", "cli"},
Active: true,
Metadata: map[string]interface{}{
"version": 1.2,
"legacy": false,
},
}
// 输出为标准 JSON 到 stdout（自动换行，符合 JSON Text 规范）
if err := json.NewEncoder(os.Stdout).Encode(data); err != nil {
log.Fatal("JSON encoding failed:", err)
}
}运行后输出：
{"name":"Alice","age":30,"tags":["golang","json","cli"],"active":true,"metadata":{"version":1.2,"legacy":false}}? 注意：字段必须首字母大写（即导出字段），否则 json 包无法访问；可通过 json:"key_name" 标签自定义键名，支持 ,omitempty 省略空值。
⚠️ 常见误区与注意事项
- ❌ 不要使用 fmt.Println(foo) 或 fmt.Printf("%+v", foo)：输出非 JSON，无引号、无类型区分，Rails 等外部系统无法解析。
- ❌ 避免手动拼接字符串（如 "{"Name":" + name + `"}``）：易出错、不安全（未转义特殊字符）、不支持嵌套与动态类型。
- ✅ 若需紧凑 JSON（无换行/空格），可使用 json.Compact 预处理字节流，但 Encoder 默认已足够简洁。
- ✅ 在与 Rails 等 Ruby 应用集成时，可将 Go 程序编译为静态二进制，通过 system() 或反引号调用，其 stdout 可被 Ruby 的 JSON.parse($?.to_s) 直接消费。
? 进阶提示：错误处理与性能
- Encode() 方法会自动调用 Flush()，适合单次输出；若需多次连续输出 JSON 值（如 JSON Lines），应复用同一 Encoder 实例。
- 对于高频调用场景，避免重复创建 Encoder；若需捕获 JSON 字符串而非直接输出，改用 json.Marshal() 并检查返回的 []byte 和 error：
bytes, err := json.Marshal(data)
if err != nil {
log.Fatal(err)
}
fmt.Print(string(bytes)) // 注意：Marshal 不自动换行总之，encoding/json 是 Go 生态中稳定、标准、零依赖的 JSON 解决方案。只要结构体设计合理、字段导出且标签得当，即可一键生成可互操作的 JSON 输出，完美满足 CLI 集成、API 原型或跨语言数据交换需求。
