Conceptos básicos de la cadena de herramientas de Go

10 ejemplos para empezar con la cadena de herramientas de Go: 7 básicos y 3 intermedios.

Prerrequisitos

• Instala Go 1.26.x o posterior desde go.dev/dl.
• Crea un módulo: mkdir tooldemo && cd tooldemo && go mod init example.com/tooldemo.
• Guarda los fragmentos de shell en la raíz del módulo a menos que se muestre una ruta.

Ejemplos básicos

1. Comprobar la versión de la cadena de herramientas

Confirma qué versión de Go está activa antes de depurar diferencias en la compilación.

go version

• Imprime la versión del compilador y el sistema operativo/arquitectura de destino.
• Compara la salida entre el portátil y la CI cuando las compilaciones divergen.
• go env GOVERSION imprime solo la cadena de versión para scripts.

Relacionado: El comando go: Ciclo de vida de compilación, pruebas y módulos - cómo encaja el controlador

2. Compilar un binario

Compila el paquete actual sin instalarlo globalmente.

go build -o bin/server ./cmd/server

• go build sin -o nombra el binario con el nombre del directorio (server para cmd/server).
• El comando sale con un valor distinto de cero si hay errores de compilación; los scripts deben comprobar $?.
• Añade -trimpath en los pipelines de lanzamiento para eliminar las rutas de archivo de los binarios.

Relacionado: go build, run, install & clean - flags y comportamiento de la caché

3. Ejecutar desde el código fuente

Compila en un binario temporal y ejecútalo en un solo paso.

go run .

• Ideal para el desarrollo local; no para el despliegue en producción.
• Pasa argumentos después de --: go run . --port 8080.
• go run ./cmd/worker apunta a un paquete main específico.

Relacionado: go build, run, install & clean - cuándo preferir build sobre run

4. Probar un paquete

Ejecuta las pruebas en el directorio actual.

go test -v .

• -v imprime el nombre de cada prueba a medida que se ejecuta.
• Las pruebas se encuentran en archivos *_test.go junto al código de producción.
• Las pruebas fallidas salen con el estado 1, que la CI debe tratar como una puerta de seguridad estricta.

Relacionado: go test, list & generate - patrones, carreras y benchmarks

5. Probar todos los paquetes recursivamente

Ejercita todo el árbol de módulos.

go test ./...

• ./... se expande a cada paquete bajo la raíz del módulo.
• Añade -count=1 para deshabilitar la caché de resultados de pruebas al depurar fallos intermitentes.
• Combina con -race en CI para la detección de carreras de datos.

Relacionado: go test, list & generate - -race, -cover, y benchmarks

6. Inicializar e inspeccionar módulos

go mod init crea el archivo raíz del módulo.

go mod init example.com/tooldemo
cat go.mod

• La ruta del módulo debe coincidir con la ruta de alojamiento de tu VCS cuando lo publiques.
• go 1.26 en go.mod declara la versión mínima del lenguaje.
• Un go.mod por raíz de módulo; los subpaquetes lo comparten.

Relacionado: go mod tidy, vendor, download & graph - mantener los requisitos precisos

7. Sincronizar dependencias del módulo

Sincroniza go.mod con las importaciones reales.

go mod tidy

• Añade líneas require faltantes y elimina módulos no utilizados.
• Actualiza las líneas de sumas de verificación go.sum para cada módulo retenido.
• Ejecuta después de refactorizaciones que añaden o eliminan importaciones de terceros.

Relacionado: go mod tidy, vendor, download & graph - comandos vendor y graph

Ejemplos intermedios

8. Comprobación estática con go vet

Detecta construcciones sospechosas que el compilador permite.

go vet ./...

• Ejecuta analizadores como código inalcanzable y verbos fmt mal utilizados.
• Comparte el verificador de tipos con go test, por lo que compila los paquetes primero.
• Empareja con golangci-lint en CI para conjuntos de reglas más amplios.

Relacionado: Modernizadores go fix y analizadores go vet - reescrituras de corrección y analizadores personalizados

9. Listar paquetes y versiones de módulos

Inspecciona lo que ve el cargador antes de una compilación.

go list ./...
go list -m -versions golang.org/x/sync

• go list imprime rutas de importación, estado de prueba y etiquetas de compilación aplicadas.
• -m cambia al modo de módulo para consultas de versión.
• Usa go list -m all para volcar la lista completa de compilación para auditorías.

Relacionado: go test, list & generate - salida JSON y plantillas -f

10. Fijar o cambiar la cadena de herramientas con GOTOOLCHAIN

Controla qué versión de Go ejecuta los comandos.

go env GOTOOLCHAIN
GOTOOLCHAIN=go1.26.0 go version

• El valor predeterminado auto puede descargar un parche más nuevo que satisfaga go.mod.
• GOTOOLCHAIN=local prohíbe las descargas automáticas de la cadena de herramientas.
• Confirma la directiva go en go.mod para que los compañeros resuelvan la misma base.

Relacionado: Compilación cruzada y proxies de módulos privados - variables de entorno para compilaciones y módulos

Versiones de la pila: Esta página fue escrita para Go 1.26.x (predeterminado Green Tea GC, modernizadores go fix - verifica el parche en la compilación), chi (última - verifica en la compilación), gin (última - verifica en la compilación), echo (última - verifica en la compilación), google.golang.org/grpc (última - verifica en la compilación), sigs.k8s.io/controller-runtime (última - verifica en la compilación), kubebuilder (última - verifica en la compilación), tinygo (última - verifica los objetivos de la placa en la compilación), wazero (última - verifica en la compilación), y golangci-lint (última - verifica el conjunto de linters en la compilación).