Resumen de puntos destacados de Linting y Calidad

Cada viñeta destacada de las 9 páginas de esta sección, recopilada en una sola página y agrupada por la página de origen.

Calidad de código Go: Opinión por diseño

• gofmt elimina los debates sobre el formato; go vet detecta clases de errores reales
• La calidad de Go está en capas: formato, vet, pruebas, luego linters opcionales
• golangci-lint compone analizadores de la comunidad detrás de una sola configuración
• La CI es el límite de aplicación; los editores proporcionan retroalimentación temprana
• La rigurosidad debe crecer incrementalmente, no bloquear la velocidad de desarrollo inicial

Conceptos básicos de calidad de código

• gofmt es determinista, la CI debería fallar ante cualquier deriva de formato
• Usa goimports con la bandera -local para agrupar las importaciones del módulo por separado
• go vet detecta errores probables que el compilador permite
• Ejecuta las pruebas con la bandera -race y bloquea las fusiones ante fallos de las pruebas
• Fija la versión de golangci-lint en CI y comienza con los linters predeterminados
• Mantén el objetivo make check por debajo de los 2 minutos para su uso en hooks pre-push

Aplicación de gofmt y goimports

• gofmt es el único formato compatible; aplícalo con comprobaciones de diferencias en CI
• goimports gestiona las importaciones y aún así ejecuta gofmt
• Usa -local para separar las rutas de módulos internos en los bloques de importación
• El código generado puede excluirse de las comprobaciones de formato
• El formato al guardar del editor y la CI deben usar la misma versión de la herramienta

go vet y diagnósticos comunes de analizadores

• go vet ejecuta analizadores incluidos con la toolchain de Go
• Los mensajes se dirigen a errores probables, no a preferencias de estilo
• Las nuevas versiones de Go pueden añadir comprobaciones de vet que fallen en CI sin cambios en el código
• staticcheck y golangci-lint extienden vet con análisis más profundos
• Corrige la causa raíz; evita el uso generalizado de //nolint en los hallazgos de vet

Configuración de golangci-lint

• Un único .golangci.yml orquesta docenas de analizadores
• Fija la versión de golangci-lint en CI para obtener resultados reproducibles
• Excluye las rutas de código generado para evitar ruido
• Amplía el conjunto de linters incrementalmente; usa presets como puntos de partida
• Los monorepos pueden usar configuraciones por módulo o exclusiones basadas en rutas

Hooks de pre-commit y listas de verificación de revisión

• Los hooks capturan el formato y las comprobaciones rápidas antes del tiempo de cola de CI
• Mantén pre-commit por debajo de ~60s; delega el linting pesado a CI
• Las listas de verificación de PR complementan las compuertas automatizadas con juicio humano
• Documenta la política --no-verify solo para emergencias
• Alinea las herramientas de hooks con las versiones de CI fijadas

Compuertas de calidad de CI: Lint, Test, Race, Vuln

• Trata el formato, vet, test, race, lint y vuln como compuertas de fusión
• Fija las versiones de Go y golangci-lint en los flujos de trabajo
• Ejecuta trabajos en paralelo siempre que sea posible para ahorrar tiempo de reloj
• govulncheck reduce la señal de CVE a los símbolos alcanzables
• Las compuertas fallidas bloquean la fusión; documenta la política de inestabilidad y reintentos

Estándares de revisión de código para equipos Go

• El linting captura la mecánica; la revisión captura el diseño y la operabilidad
• Escanea errores, concurrencia y contexto en cada PR de servicio
• Verifica que las pruebas demuestren los modos de fallo, no solo los caminos felices
• Señala la ampliación del alcance y la falta de observabilidad antes de la fusión
• Usa severidad: bloquear, discutir o nit

Mejores prácticas de linting y calidad de código

• Aplica gofmt en CI; el código sin formato nunca se fusiona con make fmt disponible
• Ejecuta go vet en cada PR para detectar errores que el compilador omite
• Fija la versión de Go en CI para que coincida con go.mod y evite la deriva de la toolchain
• El detector de carreras bloquea la fusión para código concurrente; habilítalo con go test -race
• Ejecuta golangci-lint con una lista explícita de habilitación para evitar linters sorpresa
• Clasifica las CVE alcanzables después de govulncheck; nunca ignores silenciosamente las vulnerabilidades

636f64656775696465732e696f7c6367696f3438357c323032363037