Différences entre //go:build et // build

Dans Go 1.17, une nouvelle directive de compilation conditionnelle nommée //go:build a été introduite en remplacement de l'ancienne directive // ​​build. Bien que les deux directives servent le même objectif de spécification des contraintes de construction, il existe plusieurs différences et avantages clés à utiliser //go:build.

Différences de syntaxe :

• //go:build suit une syntaxe similaire à celle des autres directives Go, comme //go:generate. Il prend une expression booléenne comme argument, qui détermine si le fichier doit être inclus dans le package lors de la compilation.
• // build, en revanche, utilise une syntaxe moins intuitive. Il accepte une liste de balises séparées par des virgules pour spécifier les plates-formes ou conditions pour lesquelles le fichier doit être inclus.

Détails de mise en œuvre :

• Dans les versions Go 1.17 et ultérieures, //go:build est la directive préférée et sera activement supprimée par la chaîne d'outils, comme mentionné dans les notes de version Go 1.18.
• // build continuera à être pris en charge pour quelques versions de Go pour assurer une transition en douceur, mais son utilisation est déconseillée dans les versions plus récentes.

Avantages de //go:build :

• Cohérence : //go:build s'aligne sur les autres directives et pragmas de Go, ce qui le rend cohérent et plus facile à retenir.
• Amélioré Syntaxe : //go:build propose une syntaxe d'expression booléenne plus standard, utilisant & et || pour les conditions AND et OR, respectivement. Ceci contraste avec // build, qui utilisait des virgules pour AND et des espaces pour OR.
• Support Go fmt : //go:build est pris en charge par go fmt, qui corrige automatiquement les erreurs placement de la directive dans les fichiers sources. Cela permet d'éviter les erreurs courantes, comme ne pas laisser de ligne vide entre la directive et l'instruction du package.
• Messages d'erreur détaillés : //go:build fournit des messages d'erreur plus détaillés lors de la compilation, aidant à identifier tout problème avec les contraintes de construction.

Utilisation :

Bien que les deux directives soient utilisées pour spécifier les contraintes de construction, //go:build est généralement préféré en raison de ses avantages. Voici un exemple illustrant l'utilisation des deux directives :

//go:build linux && amd64
package main

//  build linux,amd64
package main

Dans cet exemple, les deux directives obtiendront le même résultat, à savoir inclure le package principal uniquement lors de la compilation pour Linux et l'architecture AMD 64 bits.

Conclusion :

//go:build offre plusieurs avantages par rapport // build, notamment une syntaxe cohérente, des messages d'erreur améliorés et la prise en charge de go fmt. Il s'agit de la directive préférée pour spécifier les contraintes de construction dans Go 1.17 et versions ultérieures.