Unterschiede zwischen //go:build und // build

In Go 1.17 wurde eine neue bedingte Kompilierungsdirektive namens //go:build als Ersatz für eingeführt die ältere // Build-Direktive. Während beide Direktiven dem gleichen Zweck der Angabe von Build-Einschränkungen dienen, gibt es mehrere wesentliche Unterschiede und Vorteile bei der Verwendung von //go:build.

Syntaxunterschiede:

• //go:build folgt einer ähnlichen Syntax wie andere Go-Anweisungen, etwa //go:generate. Es benötigt einen booleschen Ausdruck als Argument, der bestimmt, ob die Datei während der Kompilierung in das Paket aufgenommen werden soll.
• // build hingegen verwendet eine weniger intuitive Syntax. Es akzeptiert eine durch Kommas getrennte Liste von Tags, um anzugeben, für welche Plattformen oder Bedingungen die Datei enthalten sein soll.

Implementierungsdetails:

• In Go-Versionen 1.17 und höher: //go:build ist die bevorzugte Direktive und wird aktiv von der Toolchain entfernt, wie in den Versionshinweisen zu Go 1.18 erwähnt.
• // Build wird für einige Go-Releases weiterhin unterstützt, um einen reibungslosen Übergang zu gewährleisten, von seiner Verwendung wird jedoch in neueren Versionen abgeraten.

Vorteile von //go:build:

• Konsistenz: //go:build stimmt mit den anderen Anweisungen und Pragmas von Go überein und macht es konsistent und einfacher Denken Sie daran.
• Verbesserte Syntax: //go:build bietet eine standardmäßigere Syntax für boolesche Ausdrücke mit & und || für UND- bzw. ODER-Bedingungen. Dies steht im Gegensatz zu // build, bei dem Kommas für AND und Leerzeichen für OR verwendet wurden.
• Go fmt-Unterstützung: //go:build wird von go fmt unterstützt, das Fehler automatisch behebt Platzierung der Direktive in Quelldateien. Dies hilft, häufige Fehler zu vermeiden, z. B. keine Leerzeile zwischen der Direktive und der Paketanweisung zu lassen.
• Detaillierte Fehlermeldungen: //go:build stellt während der Kompilierung detailliertere Fehlermeldungen bereit. Hilft bei der Identifizierung etwaiger Probleme mit den Build-Einschränkungen.

Verwendung:

Während beide Anweisungen zum Festlegen von Build-Einschränkungen verwendet werden, //go:build wird aufgrund seiner Vorteile im Allgemeinen bevorzugt. Hier ist ein Beispiel, das die Verwendung beider Direktiven demonstriert:

//go:build linux && amd64
package main

//  build linux,amd64
package main

In diesem Beispiel erzielen beide Anweisungen das gleiche Ergebnis, nämlich das Einschließen des Hauptpakets nur beim Kompilieren für Linux und 64-Bit-AMD-Architektur.

Schlussfolgerung:

//go:build bietet gegenüber // build mehrere Vorteile, darunter eine konsistente Syntax, verbesserte Fehlermeldungen und go-fmt-Unterstützung. Dies ist die bevorzugte Direktive zum Festlegen von Build-Einschränkungen in Go 1.17 und höher.