Различия между //go:build и // build

В Go 1.17 новая директива условной компиляции под названием //go:build была введена в качестве замены старая // директива сборки. Хотя обе директивы служат одной и той же цели - указанию ограничений сборки, существует несколько ключевых отличий и преимуществ использования //go:build.

Различия в синтаксисе:

• //go:build имеет синтаксис, аналогичный другим директивам Go, например //go:generate. В качестве аргумента он принимает логическое выражение, которое определяет, должен ли файл быть включен в пакет во время компиляции.
• // build, с другой стороны, использует менее интуитивный синтаксис. Он принимает список тегов, разделенных запятыми, чтобы указать, для каких платформ или условий должен быть включен файл.

Детали реализации:

• В версиях Go 1.17 и более поздних версиях //go:build — предпочтительная директива, и она будет активно удаляться инструментальной цепочкой, как упоминалось в выпуске Go 1.18. примечания.
• // сборка будет по-прежнему поддерживаться в нескольких выпусках Go, чтобы обеспечить плавный переход, но ее использование не рекомендуется в более новых версиях.

Преимущества //go :build:

• Последовательность: //go:build согласуется с другими директивами и прагмами Go, создавая оно единообразно и его легче запомнить.
• Улучшенный синтаксис: //go:build предлагает более стандартный синтаксис логических выражений, используя & и || для условий И и ИЛИ соответственно. В этом отличие от // сборки, в которой для И используются запятые, а для ИЛИ — пробелы.
• Поддержка Go fmt: //go:build поддерживается go fmt, который автоматически исправляет неправильные размещение директивы в исходных файлах. Это помогает избежать распространенных ошибок, например, не оставлять пустую строку между директивой и оператором пакета.
• Подробные сообщения об ошибках: //go:build предоставляет более подробные сообщения об ошибках во время компиляции, помогают выявить любые проблемы с ограничениями сборки.

Использование:

Хотя обе директивы используются для указания ограничений сборки, //go:build обычно предпочтительнее из-за его преимуществ. Вот пример, демонстрирующий использование обеих директив:

//go:build linux && amd64
package main

//  build linux,amd64
package main

В этом примере обе директивы дадут один и тот же результат: основной пакет будет включаться только при компиляции для Linux и 64-битной архитектуры AMD.

Вывод:

//go:build предлагает несколько преимуществ по сравнению с // build, включая согласованный синтаксис, улучшенные сообщения об ошибках и поддержку go fmt. Это предпочтительная директива для указания ограничений сборки в Go 1.17 и более поздних версиях.