Чем отличаются fmt.Println() и println() в Go? Когда что использовать?

Ключевое отличие: встроенная функция vs функция из пакета

Вы абсолютно правы: println() — это встроенная функция (built-in), которая доступна без импорта. Она определена в спецификации языка Go и всегда доступна в любой программе. fmt.Println() — это функция из стандартного пакета fmt, который нужно явно импортировать.

Однако разница гораздо глубже, чем просто импорт. Вот основные отличия:

1. Предназначение и стабильность

• println() — это диагностическая функция. Она предназначена для отладки, вывода сообщений об ошибках и низкоуровневой диагностики. Её поведение может меняться в будущих версиях Go.
• fmt.Println() — это полноценная функция вывода с гарантированной стабильностью. Её поведение зафиксировано и не изменится.

2. Форматирование и типы данных

fmt.Println() использует механизм рефлексии для красивого форматирования сложных типов: срезов, структур, мап, каналов. Например:

package main

import "fmt"

type User struct {
    Name string
    Age  int
}

func main() {
    slice := []int{1, 2, 3}
    user := User{Name: "Alice", Age: 30}
    
    fmt.Println(slice) // [1 2 3]
    fmt.Println(user)  // {Alice 30}
    
    println(slice) // [3/3]0xc00001a080 (адрес в памяти)
    println(user)  // {0xc000...} (странный вывод)
}

Как видите, println() для сложных типов выводит только сырые данные (длину, ёмкость, адрес), что бесполезно для понимания содержимого.

3. Возвращаемое значение

• fmt.Println() возвращает (int, error) — количество записанных байт и ошибку (если произошла).
• println() ничего не возвращает.

4. Гарантии записи

fmt.Println() гарантирует, что вывод будет полностью записан в os.Stdout перед возвратом управления. println() может быть буферизован — в редких случаях (например, при аварийном завершении программы) вывод может быть потерян.

5. Производительность

println() работает быстрее, так как не использует рефлексию и форматирование. Но разница заметна только при миллионах вызовов — в обычном коде это несущественно.

Когда что использовать?

• Всегда используйте fmt.Println() в production-коде — для логирования, вывода результатов, сообщений пользователю.
• println() можно использовать только для быстрой отладки (например, во время разработки, чтобы не писать import). Но перед коммитом лучше заменить на fmt.Println().
• Никогда не используйте println() в библиотеках или пакетах — это считается плохим тоном.

Важное предостережение

Многие инструменты статического анализа (например, golangci-lint) помечают использование println() как ошибку или предупреждение. В некоторых проектах это может быть заблокировано на уровне CI/CD.

Итог: fmt.Println() — это стандарт де-факто. println() — это рудимент из ранних версий Go, который сохранили для обратной совместимости и отладки. Используйте его только в консольных скриптах для быстрой проверки значений.