Resumen de Puntos Clave de Reflexión y Generación de Código

Cada punto clave de las 9 páginas de esta sección, reunido en una sola página y agrupado por la página de la que proviene.

Reflexión vs. Generación de Código en Go

• La reflexión inspecciona tipos en tiempo de ejecución; la generación de código escribe código especializado en tiempo de compilación
• Los frameworks favorecen la reflexión por ergonomía; las rutas críticas (hot paths) favorecen la generación de código por velocidad
• go generate y go fix son ganchos de generación de código de primera clase en la cadena de herramientas
• Las etiquetas de struct unen ambos mundos: metadatos en el código fuente, lógica a través de reflexión o generadores
• Elija la reflexión cuando los tipos varíen en tiempo de ejecución; elija la generación de código cuando las formas se conozcan temprano

Conceptos Básicos de Reflexión

• TypeOf requiere un valor; Kind() devuelve la categoría subyacente, no el nombre del tipo
• ValueOf devuelve una copia, no una referencia; verifique CanSet() antes de mutar a través de la reflexión
• Elem() desreferencia punteros, slices, arrays, mapas y canales para acceder a los tipos subyacentes
• Pase punteros a ValueOf, use Elem(), luego llame a SetInt() cuando CanSet sea verdadero
• Lea etiquetas de struct con Tag.Get(key); los campos no exportados permanecen visibles dentro de su paquete
• Los punteros nulos conservan la información del tipo; los genéricos no cambian cómo funcionan las API de reflexión

Etiquetas de Struct y Análisis Personalizado de Etiquetas

• Las etiquetas de struct son metadatos de cadena en los campos, leídas a través de reflect.StructField.Tag
• reflect.StructTag.Get y Lookup analizan pares clave:"valor"
• Los analizadores personalizados recorren los campos una vez y almacenan en caché reflect.Type para su reutilización
• Las etiquetas impulsan json, db, validate, yaml sin cambiar los tipos de campo
• Los generadores pueden leer etiquetas de go/ast y emitir "binders" sin reflexión

Igualdad Profunda y Cambios de Kind

• reflect.DeepEqual compara valores recursivamente pero ignora campos no exportados
• Los switch de Kind se despachan según reflect.Kind antes de llamar a las API específicas del tipo
• == funciona para tipos comparables; los slices y mapas necesitan lógica explícita
• cmp.Equal y go-cmp ofrecen comparaciones de prueba más seguras que DeepEqual
• La igualdad generada supera a la reflexión en rutas de comparación críticas

Costos de Reflexión en ORM y Serializadores

• encoding/json refleja por tipo a menos que existan métodos Marshal personalizados
• Los ORM mapean structs a SQL a través de etiquetas y reflexión en cada scan o insert
• pprof a menudo muestra reflect.* bajo los manejadores de JSON y bases de datos
• jsoniter, easyjson y la generación de código reemplazan la reflexión con "codecs" generados
• sqlc y ent generan consultas; GORM sacrifica velocidad por conveniencia

go generate y stringer

• go generate ejecuta directivas //go:generate; no es parte de go build
• stringer genera String() para constantes tipadas de golang.org/x/tools
• Confirme los archivos generados o documente claramente la regeneración en CI
• Las cabeceras generadas usan // Code generated ... DO NOT EDIT
• Empareje go generate con go test en CI después de las actualizaciones de la cadena de herramientas

Creación de Generadores de Código Personalizados

• Los generadores suelen ser programas go:generate que utilizan go/packages o go/ast
• text/template o go/format.Source emiten salida Go idiomática
• Analice las etiquetas de struct del AST para evitar la reflexión en tiempo de ejecución en rutas críticas
• Escriba en stdout o *.gen.go con la cabecera Code generated
• Pruebe los generadores con packagestest o "golden files"

Directivas de go:fix inline y Migración de API

• //go:fix inline marca funciones de reenvío para reescrituras automáticas en el punto de llamada
• El modernizador inline de Go 1.26 utiliza la inserción a nivel de código fuente, no el reemplazo arbitrario de texto
• Funciona en funciones, alias de tipos y declaraciones de reenvío de constantes
• gopls muestra diagnósticos tan pronto como se agregan las directivas
• Empareje las deprecaciones con cuerpos de reenvío que llamen a la nueva API

Mejores Prácticas de Reflexión y Generación de Código

• Perfilar antes de reemplazar la reflexión con generadores
• Almacene en caché los planes de reflect.Type; nunca refleje por campo en rutas críticas
• Ejecute go generate en CI con puertas de comparación git diff
• Use //go:fix inline para deprecaciones con "shims" de reenvío
• Documente los archivos generados y fije las versiones de los generadores