Выводим структуры в Go: от новичка до профи за 10 минут

Онлайн-тренажер Python для начинающих

Изучайте Python легко и без перегрузки теорией. Решайте практические задачи с автоматической проверкой, получайте подсказки на русском языке и пишите код прямо в браузере — без необходимости что-либо устанавливать.

Начать курс

Почему "просто напечатать структуру" в Go — это не так просто?

Представьте: вы пишете на Go, создали красивую структуру User, заполнили её данными, и хотите просто взглянуть, что внутри. Вы пишете fmt.Println(user) и видите что-то вроде {Alex 25 true}. Информативно? Не очень. А если полей 15? А если одно из них — вложенная структура? А если это слайс структур?

Вопрос "How to print struct variables in console?" на Stack Overflow набрал тысячи просмотров не случайно. Каждый новичок (и не только) в Golang сталкивается с тем, что стандартный вывод структур — это скучная строка без имён полей. А когда проект разрастается, отладка превращается в гадание.

В этой статье мы разберём все способы вывода структур в консоль Go: от базовых до продвинутых. Вы узнаете, как вывести структуру красиво, с именами полей, в виде JSON, и даже как написать свой собственный метод для печати. Поехали!

▎1. Самый простой способ: fmt.Println и его ограничения

Давайте начнём с базы. У нас есть структура:

package main

import "fmt"

type User struct {
    Name   string
    Age    int
    Active bool
}

func main() {
    u := User{Name: "Анна", Age: 30, Active: true}
    fmt.Println(u)
}

Вывод:

{Анна 30 true}

Работает, но неинформативно. Вы не видите, какое значение к какому полю относится. Если в структуре 10 полей, вы будете гадать, что есть что. Особенно если тип данных повторяется (например, два поля string подряд).

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

Когда это полезно?

Вы пишете одноразовый скрипт.
Структура содержит 2-3 поля разных типов.
Вы используете fmt.Println для логов, где важна скорость, а не читаемость.

▎2. Спасительный %+v: печать с именами полей

Это, пожалуй, самый популярный ответ на Stack Overflow. Формат %+v в fmt.Printf выводит структуру с именами полей:

fmt.Printf("%+v\n", u)

Вывод:

{Name:Анна Age:30 Active:true}

Уже гораздо лучше! Вы чётко видите, где имя, возраст и статус.

Что ещё есть в арсенале fmt?

%v — стандартное представление (как в Println).
%+v — с именами полей.
%#v — полное представление с указанием пакета и типа (см. ниже).
%T — выводит только тип переменной.

Пример с %#v:

fmt.Printf("%#v\n", u)
// main.User{Name:"Анна", Age:30, Active:true}

Этот формат полезен, когда вы хотите скопировать вывод и вставить его обратно в код — это валидная литеральная инициализация структуры.

Совет: запомните комбинацию %+v — это ваш хлеб при отладке структур в Go.

▎3. Красота и порядок: сериализация в JSON

Когда структура большая, вложенная или содержит слайсы, %+v может стать нечитаемым. Тут на помощь приходит JSON. Go стандартно умеет превращать структуру в JSON:

package main

import (
    "encoding/json"
    "fmt"
)

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

type User struct {
    Name    string  `json:"name"`
    Age     int     `json:"age"`
    Active  bool    `json:"active"`
    Address Address `json:"address"`
}

func main() {
    u := User{
        Name:   "Иван",
        Age:    28,
        Active: true,
        Address: Address{
            City:   "Москва",
            Street: "Тверская",
        },
    }

    // Красивый вывод с отступами
    data, _ := json.MarshalIndent(u, "", "  ")
    fmt.Println(string(data))
}

Вывод:

{
  "name": "Иван",
  "age": 28,
  "active": true,
  "address": {
    "city": "Москва",
    "street": "Тверская"
  }
}

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

Важные нюансы:

Поля структуры должны быть экспортируемыми (с большой буквы), иначе JSON их не увидит.
Теги json:"name" — опциональны, но они делают вывод красивее (имена полей в camelCase).
Если структура содержит бинарные данные или кастомные типы, может потребоваться реализация MarshalJSON.

▎4. Кастомный метод String(): контроль над выводом

Если вам нужно выводить структуру в консоль постоянно и определённым образом (например, только ID и имя, или в одну строку), реализуйте интерфейс Stringer из пакета fmt.

Интерфейс Stringer требует один метод:

type Stringer interface {
    String() string
}

Реализуем его для нашей структуры:

func (u User) String() string {
    return fmt.Sprintf("User[%s, %d лет, активен: %t]", u.Name, u.Age, u.Active)
}

func main() {
    u := User{Name: "Ольга", Age: 35, Active: false}
    fmt.Println(u) // теперь выведет: User[Ольга, 35 лет, активен: false]
}

Теперь fmt.Println(u) и fmt.Printf("%v", u) будут использовать ваш метод. Это очень удобно, если структура используется в разных местах программы.