Busca en todas las páginas de la documentación
Go puede tener como objetivo WebAssembly sin cgo: la ruta del navegador utiliza GOOS=js GOARCH=wasm con syscall/js, y la ruta del servidor/borde utiliza GOOS=wasip1 GOARCH=wasm para hosts WASI.
cgo no está disponible en los objetivos de wasm, por lo que la interconexión se traslada a puentes de JavaScript, importaciones de WASI o TinyGo para compilaciones restringidas.
WebAssembly es una alternativa portátil a cgo nativo cuando implementa en navegadores, entornos de ejecución de borde o complementos aislados.
Los pipelines de compilación completos, la optimización del tamaño y las comparaciones de hosts se encuentran en la sección WebAssembly y TinyGo: esta página orienta a los lectores de cgo sobre cuándo cambiar.
Tarjeta de receta de referencia rápida, lista para copiar y pegar.
# wasm del navegador (syscall/js)
GOOS=js GOARCH=wasm go build -o app.wasm ./cmd/app
# WASI preview1 (servidores, wazero, wasmtime)
GOOS=wasip1 GOARCH=wasm go build -o app.wasm ./cmd/appCuándo recurrir a esto:
.wasm con WASI en lugar de libc.CGO_ENABLED=0 es obligatorio y las llamadas al sistema nativas no están disponibles.Un programa WASI mínimo que escribe en stdout (sin cgo, sin syscall/js).
// cmd/hello/main.go
package main
import "fmt"
func main() {
fmt.Println("hello wasi")
}GOOS=wasip1 GOARCH=wasm go build -o hello.wasm ./cmd/hello
wasmtime hello.wasmLo que esto demuestra:
fmt estándar funciona en wasip1 a través de importaciones WASI enlazadas por el tiempo de ejecución wasm de Go.//go:build !wasm.wasmtime, wazero, Spin, etc.), no ./hello.wasm directamente.syscall/js expone valores y devoluciones de llamada de JavaScript para GOOS=js; no se utiliza en wasip1.| Preocupación | cgo nativo | Go wasm |
|---|---|---|
| Bibliotecas C | Enlaza .so/.a | No disponible; use puertos o hosts wasm |
| DOM del navegador | No aplicable | Devoluciones de llamada de syscall/js |
| E/S de archivos | libc / x/sys | Archivos WASI o puente fs de JS |
| Tamaño binario | Nativo ELF/Mach-O | Módulo .wasm (gc wasm es más grande que TinyGo) |
| Hilos | Hilos del SO | Hilos wasm limitados; verifique el soporte del host |
| Ruta | Compilación | Host | Inmersión profunda |
|---|---|---|---|
| Navegador | GOOS=js GOARCH=wasm | Navegador + wasm_exec.js | syscall/js Go en el Navegador |
| Servidor WASI | GOOS=wasip1 GOARCH=wasm | wasmtime, wazero | Compilación con GOOS=wasip1 |
| TinyGo MCU | tinygo build -target=… | Placa o wasm | TinyGo para microcontroladores |
//go:build !js && !wasm
package plugin
// implementación nativa solo para cgo//go:build js || wasm
package plugin
// stub seguro para wasm o implementación pura de GoDivida los paquetes para que el código de interconexión no arrastre import "C" a las compilaciones de wasm.
wasm_exec.js - Errores del cargador. Solución: Siga el cableado del wiki de Go wasm para su empaquetador.net completo en js/wasm - Restringido por los entornos aislados del host. Solución: Use puentes fetch/WebSocket documentados para syscall/js.wasip1 y js - Conjuntos de llamadas al sistema diferentes. Solución: Paquetes main separados o etiquetas de compilación explícitas por objetivo.| Alternativa | Usar cuando | No usar cuando |
|---|---|---|
| Servicio nativo cgo | Necesita SDK C en servidores Linux | El objetivo es el navegador o un host solo wasm |
Puente syscall/js | Se requieren API DOM y del navegador | Trabajos por lotes WASI sin cabeza |
| TinyGo wasm | Las restricciones de tamaño y MCU dominan | Necesita funciones completas de genéricos/tiempo de ejecución |
| Módulo wasm Rust/C++ | El equipo ya envía wasm allí | Tienda solo de Go quiere un idioma |
| RPC a sidecar nativo | Las bibliotecas C pesadas permanecen en Linux | El aislamiento wasm es obligatorio |
No: las compilaciones de WebAssembly son Go puro con llamadas al sistema específicas del objetivo.
Planifique la interconexión sin import "C".
js tiene como objetivo los navegadores con syscall/js.
wasip1 tiene como objetivo los tiempos de ejecución WASI con importaciones similares a POSIX, no el DOM.
Consulte WebAssembly y TinyGo en este sitio: orden de sección 38 en el manifiesto de la guía de Go.
Comience con Go en WebAssembly.
Las versiones recientes han mejorado el tiempo de ejecución y el comportamiento de la memoria de wasm.
Lea Mejoras en el tiempo de ejecución wasm de Go 1.26 para conocer los detalles fijados en esta guía.
Microcontroladores, módulos de menos de un megabyte y wasm integrados.
Use gc wasm cuando necesite compatibilidad completa con stdlib y hosts de clase de escritorio.
Sí: wazero es un tiempo de ejecución wasm puro de Go adecuado para incrustar.
Consulte Runtimes de host WASI.
Use valores de función y devoluciones de llamada de syscall/js.
Mantenga los límites estrechos para evitar fugas de goroutines a través de eventos JS.
WASI define importaciones de sistemas de archivos y entornos; los hosts los mapean a recursos reales o virtuales.
Las capacidades varían según la configuración del host.
Sí: lógica de negocio en paquetes puros de Go con puntos de entrada de plataforma etiquetados.
Mantenga cgo aislado detrás de //go:build cgo && !wasm.
No: la integración nativa del SO en Linux/macOS/Windows todavía necesita cgo o x/sys.
Wasm es una superficie de implementación adicional.
Los binarios gc wasm a menudo tienen decenas de MB sin comprimir antes de gzip.
TinyGo tiene objetivos órdenes de magnitud más pequeños cuando el subconjunto de lenguaje es aceptable.
wasmtime, wazero y Spin aparecen en la sección dedicada.
Verifique las versiones en la compilación según los pines del manifiesto para tinygo y wazero.
Versiones de pila: Esta página fue escrita para Go 1.26.x (predeterminado Green Tea GC, modernizadores de go fix - verifique el parche en la compilación), chi (última versión - verifique en la compilación), gin (última versión - verifique en la compilación), echo (última versión - verifique en la compilación), google.golang.org/grpc (última versión - verifique en la compilación), sigs.k8s.io/controller-runtime (última versión - verifique en la compilación), kubebuilder (última versión - verifique en la compilación), tinygo (última versión - verifique los objetivos de placa en la compilación), wazero (última versión - verifique en la compilación) y golangci-lint (última versión - verifique el conjunto de linters en la compilación).
Revisado por Chris St. John·Última actualización: 18 jul 2026