go 1.12+才稳定支持webassembly，需用go version确认版本；必须复制goroot/misc/wasm/wasm_exec.js到项目；main.go末尾须调js.wait()阻塞；浏览器需http服务且响应头为application/wasm。
确认 Go 版本是否支持 WebAssembly
Go 从 1.11 开始实验性支持 WebAssembly，但稳定可用要到 1.12+；低于 1.11 的版本压根没有 js/wasm 构建目标。运行 go version 确认，如果输出是 go1.10.8 或更早，必须升级。
常见错误现象：GOOS=js GOARCH=wasm go build 报错 build constraints exclude all Go files，大概率就是版本太低或没装标准库的 wasm 运行时支持。
- 推荐用
1.19+（长期支持版），避免1.21中移除syscall/js后的兼容震荡 - Mac M1/M2 用户注意：Go 官方二进制已原生支持 arm64，无需 Rosetta，但别用 Homebrew 装的旧版
- Windows 用户若用 WSL，确保宿主机 Go 版本而非 WSL 内的版本参与构建（因为最终产物要在浏览器跑）
构建 wasm_exec.js 并配对使用
wasm_exec.js 不是自动生成的，它来自 Go 安装目录下的示例文件，必须手动复制到项目中，否则浏览器加载 .wasm 时会卡在初始化阶段，控制台报 ReferenceError: Go is not defined。
路径位置取决于你的 Go 安装方式：
立即学习“go语言免费学习笔记（深入）”；
- 官方二进制安装：
$GOROOT/misc/wasm/wasm_exec.js - 通过
gvm或asdf管理的版本：查go env GOROOT再拼路径 - 千万别用网上搜到的“老版本”
wasm_exec.js，它和当前 Go 版本的syscall/jsABI 不兼容，会导致panic: bad callback signature
构建命令本身很简单：GOOS=js GOARCH=wasm go build -o main.wasm main.go，但缺了 wasm_exec.js 就等于没完成环境配置。
main.go 必须调用 syscall/js.Wait() 阻塞
Wasm 模块在浏览器中启动后，如果 Go 主 goroutine 执行完就退出，整个实例会立即销毁，所有注册的 JS 函数（比如 js.Global().Set("add", ...)）都失效。现象是 JS 调用时静默失败，或报 TypeError: xxx is not a function。
正确写法只有一行关键阻塞：
package main
import "syscall/js"
func main() {
js.Global().Set("add", js.FuncOf(func(this js.Value, args []js.Value) interface{} {
return args[0].Int() + args[1].Int()
}))
js.Wait() // ← 必须有，且必须在最后
}
- 不要用
select {}或time.Sleep(time.Hour)替代 —— 它们不响应 JS 事件循环，js.Wait()是唯一保证与 JS 互操作持续存活的机制 - 如果你用的是
golang.org/x/exp/shiny或其它实验性 GUI 库，它们内部可能已封装等待逻辑，但纯syscall/js场景下绕不开这句
浏览器加载时注意 MIME 类型和服务器配置
本地直接双击 HTML 文件打开，或用 file:// 协议访问，99% 会失败：浏览器拒绝加载 .wasm 文件，控制台显示 Failed to load module script: Expected a JavaScript module script but the server responded with a MIME type of "" 或更隐蔽的 net::ERR_FAILED。
根本原因是：Wasm 文件需由 HTTP 服务器提供，且响应头必须含 Content-Type: application/wasm。主流静态服务器默认不识别 .wasm 后缀。
- 开发阶段最快方案：
go exec -c "python3 -m http.server 8080"（Python 3.7+），再手动加个.mime.types文件或改源码补类型（不推荐） - 更稳做法：用
npm install -g local-web-server，然后ws --mime-types '{"wasm": "application/wasm"}' - 如果你用
webpack或Vite，记得配assetInlineLimit: 0避免 wasm 被 base64 内联 —— wasm 不支持 data URL 加载
这个环节最容易被当成“Go 配置问题”去排查，其实和 Go 本身无关，纯粹是前端部署细节没对齐。
