Как вывести структуру (struct) в консоль в Go: полный разбор способов

Проблема читаемого вывода структур в Go

Действительно, стандартный вывод структур через fmt.Println или fmt.Printf("%v", ...) даёт плоскую строку без имён полей. Это особенно неудобно при отладке сложных или вложенных структур. В Go есть несколько встроенных способов и один универсальный — использование пакета encoding/json.

Способ 1: Спецификаторы формата fmt.Printf (быстрый, но ограниченный)

Встроенные спецификаторы:

• %v — значения полей без имён: {Иван 30 ivan@example.com}
• %+v — значения с именами полей: {Name:Иван Age:30 Email:ivan@example.com}
• %#v — полное представление с типом: main.User{Name:"Иван", Age:30, Email:"ivan@example.com"}

Пример:

package main

import "fmt"

type User struct {
    Name  string
    Age   int
    Email string
}

func main() {
    user := User{Name: "Иван", Age: 30, Email: "ivan@example.com"}
    fmt.Printf("%%v:  %v\n", user)
    fmt.Printf("%%+v: %+v\n", user)
    fmt.Printf("%%#v: %#v\n", user)
}

Вывод:

%v:  {Иван 30 ivan@example.com}
%+v: {Name:Иван Age:30 Email:ivan@example.com}
%#v: main.User{Name:"Иван", Age:30, Email:"ivan@example.com"}

Способ 2: Сериализация в JSON (рекомендуемый для отладки)

Лучший способ получить читаемый многострочный вывод — преобразовать структуру в JSON с отступами. Используем пакет encoding/json:

package main

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

type User struct {
    Name  string
    Age   int
    Email string
}

func main() {
    user := User{Name: "Иван", Age: 30, Email: "ivan@example.com"}
    
    // Красивый вывод с отступами
    jsonBytes, err := json.MarshalIndent(user, "", "  ")
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(string(jsonBytes))
}

Вывод:

{
  "Name": "Иван",
  "Age": 30,
  "Email": "ivan@example.com"
}

Этот способ работает с любыми структурами, включая вложенные, срезы и карты. Если поля экспортируемые (с большой буквы), они будут включены в вывод. Для неэкспортируемых полей (с маленькой буквы) используйте json.MarshalIndent с тегами json:"field_name".

Способ 3: Реализация интерфейса Stringer

Если нужно кастомное форматирование, реализуйте метод String() string для вашей структуры:

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

func main() {
    user := User{Name: "Иван", Age: 30, Email: "ivan@example.com"}
    fmt.Println(user) // автоматически вызовет String()
}

Способ 4: Пакет spew (для глубокой отладки)

Для максимально детального вывода используйте сторонний пакет github.com/davecgh/go-spew/spew. Он показывает типы, адреса указателей, глубину вложенности:

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

spew.Dump(user)
// Вывод:
// (main.User) {
//  Name: (string) "Иван",
//  Age: (int) 30,
//  Email: (string) "ivan@example.com"
// }

Рекомендация

Для повседневной отладки используйте json.MarshalIndent — он встроенный, не требует сторонних зависимостей и даёт читаемый результат. Для глубокой инспекции (включая приватные поля) — spew.Dump. А для простых случаев достаточно %+v.

package main

import (
    "log/slog"
    "os"
)

type User struct {
    Name  string
    Age   int
    Email string
}

func main() {
    user := User{Name: "Иван", Age: 30, Email: "ivan@example.com"}
    
    logger := slog.New(slog.NewTextHandler(os.Stdout, nil))
    logger.Info("user info", "user", user)
}

time=2024-01-15T10:00:00.000Z level=INFO msg="user info" user="{Иван 30 ivan@example.com}"