Как вывести содержимое структуры (struct) в консоль в Go?

Использование %+v для подробного вывода

В Go есть встроенные возможности для форматированного вывода структур. Самый простой способ увидеть имена полей — использовать спецификатор %+v в функциях пакета fmt. Он добавляет имена полей к значениям.

package main

import "fmt"

type Address struct {
    City    string
    Street  string
    ZipCode int
}

type User struct {
    Name    string
    Age     int
    Email   string
    Address Address
}

func main() {
    user := User{
        Name:  "John Doe",
        Age:   30,
        Email: "john@example.com",
        Address: Address{
            City:    "New York",
            Street:  "5th Avenue",
            ZipCode: 10001,
        },
    }
    
    // Вывод с именами полей
    fmt.Printf("User: %+v\n", user)
    // Результат:
    // User: {Name:John Doe Age:30 Email:john@example.com Address:{City:New York Street:5th Avenue ZipCode:10001}}
}

Форматированный вывод с %#v (полный синтаксис Go)

Спецификатор %#v выводит структуру в виде синтаксиса Go, который можно скопировать и использовать в коде:

fmt.Printf("%#v\n", user)
// main.User{Name:"John Doe", Age:30, Email:"john@example.com", Address:main.Address{City:"New York", Street:"5th Avenue", ZipCode:10001}}

Многострочный вывод для удобства чтения

Если структура большая, удобно использовать многострочный вывод. Вот несколько подходов:

1. Ручное форматирование через Sprintf

output := fmt.Sprintf("Name: %s\nAge: %d\nEmail: %s\nAddress:\n  City: %s\n  Street: %s\n  Zip: %d",
    user.Name, user.Age, user.Email,
    user.Address.City, user.Address.Street, user.Address.ZipCode)
fmt.Println(output)

2. Использование пакета encoding/json для красивого JSON-вывода

Это самый популярный способ для отладки сложных структур:

import (
    "encoding/json"
    "fmt"
)

func main() {
    user := User{...} // ваш код
    
    jsonData, err := json.MarshalIndent(user, "", "  ")
    if err != nil {
        fmt.Println("Ошибка маршалинга:", err)
        return
    }
    fmt.Println(string(jsonData))
    // Вывод:
    // {
    //   "Name": "John Doe",
    //   "Age": 30,
    //   "Email": "john@example.com",
    //   "Address": {
    //     "City": "New York",
    //     "Street": "5th Avenue",
    //     "ZipCode": 10001
    //   }
    // }
}

Важно: Для работы JSON-вывода поля структуры должны быть экспортируемыми (начинаться с большой буквы). Если у вас есть приватные поля, JSON их не покажет.

Кастомный метод String()

Вы можете определить метод String() для вашей структуры, который будет автоматически вызываться при использовании fmt.Println:

func (u User) String() string {
    return fmt.Sprintf("User[Name=%s, Age=%d, Email=%s, City=%s]",
        u.Name, u.Age, u.Email, u.Address.City)
}

func main() {
    user := User{...}
    fmt.Println(user) // автоматически вызовет String()
    // User[Name=John Doe, Age=30, Email=john@example.com, City=New York]
}

Дополнительные советы

• Для отладки используйте %+v — это быстро и не требует импорта дополнительных пакетов.
• Для сложных структур с вложенностью — JSON с MarshalIndent даёт наилучшую читаемость.
• Если структура содержит указатели, %+v покажет адрес памяти. Используйте JSON или реализуйте String() для рекурсивного разыменования.
• Для продакшена избегайте вывода всех полей, если есть чувствительные данные (пароли, токены). Реализуйте String() с фильтрацией.

Выберите подход, который лучше всего подходит под вашу задачу. Для быстрой отладки — %+v, для красивых отчётов — JSON, для контроля над форматом — кастомный String().

import "github.com/davecgh/go-spew/spew"

func main() {
    user := User{...}
    spew.Dump(user)
    // (main.User) {
    //  Name: (string) "John Doe",
    //  Age: (int) 30,
    //  Email: (string) "john@example.com",
    //  Address: (main.Address) {
    //   City: (string) "New York",
    //   Street: (string) "5th Avenue",
    //   ZipCode: (int) 10001
    //  }
    // }
}