Resumen de puntos destacados de funciones avanzadas

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

Más allá de la especificación: Embed, Modos de compilación y Ensamblaje

• go:embed integra activos en binarios en tiempo de compilación
• Las restricciones de compilación seleccionan archivos fuente específicos de la plataforma
• buildmode cambia lo que produce el enlazador
• El ensamblaje es un último recurso para las rutas críticas
• Las funciones de potencia intercambian simplicidad por control operativo

Conceptos básicos de las funciones avanzadas del lenguaje

• Incrusta archivos con la directiva //go:embed; requiere reconstrucción cuando los archivos incrustados cambian
• Usa fs.Sub para eliminar prefijos de directorio para http.FileServer y análisis de plantillas
• Prefiere go:build sobre +build heredado; combina restricciones con &&, || y !
• Los sufijos de archivo como _linux.go implican restricciones de compilación sin directiva explícita
• Ejecuta pruebas de integración con -tags=integration; CI puede segregarlas por separado
• Elimina símbolos y DWARF con las banderas -s y -w para reducir los binarios de lanzamiento

//go:embed para archivos y plantillas

• La incrustación en tiempo de compilación elimina las dependencias de rutas de activos en tiempo de ejecución
• embed.FS funciona con io/fs y http.FileServer
• html/template y text/template admiten ParseFS
• Los patrones no pueden hacer referencia a directorios padre ni a archivos ocultos (dotfiles)
• Se requiere reconstrucción cuando cambia el contenido incrustado

Restricciones de compilación y archivos específicos de plataforma

• Las líneas //go:build seleccionan archivos en tiempo de compilación
• GOOS y GOARCH son términos de restricción implícitos
• Los sufijos de archivo proporcionan una abreviatura para plataformas comunes
• Las etiquetas personalizadas -tags extienden la matriz de compilación
• Los archivos sin etiqueta compilan en todas partes

Ensamblaje en Go (archivos *.s)

• Go utiliza la sintaxis de ensamblaje de Plan 9, no Intel
• Las prototipos de Go y los archivos .s comparten un paquete
• Los símbolos TEXT deben respetar la ABI de Go y los mapas de pila
• Proporciona alternativas puras de Go para GOARCH no compatibles
• Perfila antes de mantener el ensamblaje a largo plazo

Indicadores del enlazador y opciones de buildmode

• -buildmode cambia el tipo de artefacto de salida del enlazador
• -ldflags inyecta metadatos de versión y elimina información de depuración
• c-archive y c-shared exponen Go a los llamadores de C
• El modo plugin produce objetos .so cargables en sistemas operativos compatibles
• Las canalizaciones de lanzamiento deben registrar los comandos de compilación exactos

Paquetes de plugins y carga dinámica

• plugin.Open carga objetos compartidos compilados en Go en tiempo de ejecución
• El host y el plugin deben compartir la versión de Go y dependencias compatibles
• Compatible con Linux, FreeBSD y macOS; no con Windows
• Los símbolos se exportan a través de Lookup en *plugin.Plugin
• Prefiere RPC o procesos separados para la mayoría de la extensibilidad

Directivas del compilador: //go:noinline, linkname y go:fix inline

• Las directivas del compilador son pistas de la cadena de herramientas, no API públicas
• //go:noinline evita la inlining para pruebas y límites
• //go:linkname conecta símbolos entre paquetes de forma insegura
• Los modernizadores go fix automatizan las migraciones de API en Go 1.26+
• Prefiere código ordinario a menos que el perfilado o la migración requieran pistas

Mejores prácticas para funciones avanzadas del lenguaje

• Perfila antes de usar ensamblaje; prefiere indicadores de tiempo de ejecución sobre etiquetas de compilación
• Incrusta solo activos que se envían en el binario; nunca incrustes secretos
• Fija ldflags y etiquetas de compilación en Makefile para artefactos reproducibles
• Reconstruye el host y los plugins en la misma versión de parche de Go para compatibilidad
• Proporciona alternativas puras de Go para ensamblaje; evita linkname en aplicaciones
• Utiliza funciones de potencia solo con una necesidad operativa clara