Diferenças entre //go:build e // build

No Go 1.17, uma nova diretiva de compilação condicional chamada //go:build foi introduzida como um substituto para a diretiva // build mais antiga. Embora ambas as diretivas tenham o mesmo propósito de especificar restrições de construção, há várias diferenças e vantagens importantes em usar //go:build.

Diferenças de sintaxe:

• //go:build segue uma sintaxe semelhante a outras diretivas Go, como //go:generate. Ele usa uma expressão booleana como argumento, que determina se o arquivo deve ser incluído no pacote durante a compilação.
• // build, por outro lado, usa uma sintaxe menos intuitiva. Ele aceita uma lista de tags separadas por vírgula para especificar em quais plataformas ou condições o arquivo deve ser incluído.

Detalhes de implementação:

• In Go versões 1.17 e posteriores, //go:build é a diretiva preferida e será ativamente removida pelo conjunto de ferramentas, conforme mencionado nas notas de lançamento do Go 1.18.
• // build continuará a ser compatível com algumas versões Go para garantir uma transição suave, mas seu uso é desencorajado em versões mais recentes.

Vantagens de //go:build:

• Consistência: //go:build se alinha com outras diretivas e pragmas do Go, tornando-o consistente e mais fácil de lembrar.
• Melhorado Sintaxe: //go:build oferece uma sintaxe de expressão booleana mais padrão, usando & e || para condições AND e OR, respectivamente. Isso contrasta com // build, que usava vírgulas para AND e espaços para OR.
• Go fmt Support: //go:build é compatível com go fmt, que corrige automaticamente erros colocação da diretiva nos arquivos fonte. Isso ajuda a evitar erros comuns, como não deixar uma linha em branco entre a diretiva e a instrução do pacote.
• Mensagens de erro detalhadas: //go:build fornece mensagens de erro mais detalhadas durante a compilação, ajudando a identificar quaisquer problemas com as restrições de construção.

Uso:

Embora ambas as diretivas sejam usadas para especificar restrições de construção, //go:build é geralmente preferido devido às suas vantagens. Aqui está um exemplo que demonstra o uso de ambas as diretivas:

//go:build linux && amd64
package main

//  build linux,amd64
package main

Neste exemplo, ambas as diretivas alcançarão o mesmo resultado, que é incluir o pacote principal apenas ao compilar para Linux e arquitetura AMD de 64 bits.

Conclusão:

//go:build oferece diversas vantagens sobre // build, incluindo uma sintaxe consistente, mensagens de erro aprimoradas e suporte go fmt. É a diretiva preferida para especificar restrições de construção no Go 1.17 e posterior.