Go 1.11起原生支持WebAssembly，但稳定可用需Go 1.13+；必须用GOOS=js GOARCH=wasm编译，配套wasm_exec.js胶水脚本、application/wasm MIME类型及js.Wait()或select{}阻塞主goroutine才能在浏览器正确运行。
确认 Go 版本是否支持 WebAssembly
Go 1.11 起才正式支持 WebAssembly，但真正稳定可用要从 Go 1.13 开始；低于 Go 1.13 的版本编译出的 wasm 文件无法被现代浏览器（Chrome/Firefox/Edge）正确加载，会报 RuntimeError: abort(CompileError: WebAssembly.instantiate(): expected magic word 00 61 73 6d, found 3c 21 44 4f) 这类错误——本质是输出了 HTML 内容而非二进制 wasm。
运行以下命令检查：
go version
若低于 go1.13，请升级到 Go 1.19+（推荐 LTS 版本），因为 Go 1.21 起默认启用 CGO_ENABLED=0，而 WebAssembly 目标不支持 CGO，所以旧版反而更“宽容”，新版需显式注意这点。
用 GOOS=js GOARCH=wasm 编译最简程序
WebAssembly 在 Go 中不是独立 SDK，而是两个构建约束：GOOS=js 表示目标运行时为 JavaScript 环境，GOARCH=wasm 指定架构。二者必须同时出现，缺一不可。
立即学习“go语言免费学习笔记（深入）”；
写一个 main.go：
package main
import (
"fmt"
"syscall/js"
)
func main() {
fmt.Println("Hello from WebAssembly!")
js.Global().Set("add", js.FuncOf(func(this js.Value, args []js.Value) interface{} {
return args[0].Float() + args[1].Float()
}))
select {} // 阻塞主 goroutine，防止程序退出
}
编译命令必须带完整环境变量：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
GOOS=js GOARCH=wasm go build -o main.wasm
- 不能漏掉
GOOS=js，否则js包会编译失败（import "syscall/js" used but not imported） -
main.wasm是纯二进制文件，不能直接双击或用file命令查看内容——它需要配套的 JavaScript 加载胶水代码 - 必须有
select{}或其他阻塞逻辑，否则程序立即退出，JS 函数注册无效
用 copy GOROOT/misc/wasm/wasm_exec.js 启动浏览器环境
Go 自带一份胶水 JS（wasm_exec.js），它负责初始化 WebAssembly 实例、桥接 Go 运行时与浏览器 API。路径在 $GOROOT/misc/wasm/wasm_exec.js，必须复制到项目目录下使用，不能通过 CDN 或 npm 引入——因为版本必须严格匹配当前 Go 安装版本。
写一个最小 HTML 页面：
<!DOCTYPE html>
<html>
<head><meta charset="utf-8"></head>
<body>
<script src="wasm_exec.js"></script>
<script>
const go = new Go();
WebAssembly.instantiateStreaming(fetch("main.wasm"), go.importObject).then((result) => {
go.run(result.instance);
console.log(add(2, 3)); // 输出 5
});
</script>
</body>
</html>
关键点：
- 必须用
WebAssembly.instantiateStreaming（非instantiate），且服务端需返回正确的content-type: application/wasm，否则 Chrome 报compile error - 不能直接用
file://协议打开 HTML——浏览器会因 CORS 拒绝加载main.wasm，必须起本地 HTTP 服务，例如：python3 -m http.server 8080
-
wasm_exec.js里硬编码了 Go 运行时行为，比如console.log映射、setTimeout封装，换 Go 版本后务必重拷
调试时 panic 不显示堆栈？用 js.Global().Get("console").Call("error", ...)
Go 的 panic 在 WASM 下默认不打印完整堆栈，只输出 panic: … 到控制台，且程序直接终止。这是因为 WASM 没有标准 stderr，Go 运行时未将 panic 信息透传给 JS console。
临时调试建议：
- 把关键逻辑包在
recover()里，并手动调用 JS 控制台：defer func() { if r := recover(); r != nil { js.Global().Get("console").Call("error", "PANIC:", r) } }() - 避免在
js.FuncOf回调中直接 panic，应先if !args[0].Valid() { ... }校验参数有效性 - 用
fmt.Printf替代fmt.Println可获得更可控的输出时机（WASM 中fmt.Println实际走的是异步 JS log）
真正上线前，所有 js.FuncOf 必须做参数防御，因为 JS 侧可传任意类型（null、undefined、对象），而 Go 的 js.Value.Float() 遇到非数字会 panic。
