go编译wasm必须严格使用goos=js goarch=wasm组合，配对同版本wasm_exec.js，通过http服务加载并调用js.wait()阻塞主goroutine，否则必现白屏或运行时错误。
Go 编译出的 main.wasm 不能直接在浏览器里运行，必须配对版本一致的 wasm_exec.js，且 GOOS=js GOARCH=wasm 是唯一受支持的构建组合——用错目标或混用旧版胶水脚本，90% 的白屏、unreachable、go.run is not a function 都源于此。
GOOS=js GOARCH=wasm 是强制组合，不是可选参数
Go 官方只支持这一种 WASM 构建目标，GOOS=wasm 或 GOARCH=wasi 等写法在 1.23 及之前版本会静默忽略或报错。低于 Go 1.21 的版本（如 1.20）即使命令写对，生成的 main.wasm 在现代浏览器中大概率触发 RuntimeError: unreachable——不是代码问题，是运行时 ABI 不匹配。
-
GOOS=js启用 JS 平台专用运行时，包含syscall/js绑定和内存初始化逻辑 -
GOARCH=wasm必须与GOOS=js同时出现，单独设GOARCH=wasm无效 - 正确命令只有一行：
GOOS=js GOARCH=wasm go build -o main.wasm main.go - 输出是纯二进制
main.wasm，不含 HTML/JS，不能双击打开，也不能直接import加载
wasm_exec.js 必须和 Go 版本严格对应
wasm_exec.js 不是通用胶水，而是与 Go 编译器版本强绑定的运行时桥接层。Go 1.22 编译的 main.wasm 若搭配 Go 1.21 的 wasm_exec.js，会报 undefined symbol: runtime.wasmExit 或 ReferenceError: go is not defined。
- 路径固定为
$(go env GOROOT)/misc/wasm/wasm_exec.js，每次升级 Go 后必须重新拷贝 - 必须用
<script src="wasm_exec.js"></script>同步加载，且要在调用go.run()前执行完毕 - 不能用
await import('/wasm_exec.js')动态导入（Vite 等工具中易出竞态），除非确保加载完成后再实例化 WASM - 常见错误：HTML 中
<script></script>标签位置靠后，或wasm_exec.js路径 404，导致go全局对象未定义
main() 结束前必须阻塞，否则瞬间退出
Go WASM 模块启动后执行 main()，然后立即终止——WASM 没有后台线程，主 goroutine 结束 = 整个实例销毁。不阻塞会导致注册的 JS 回调失效、fmt.Println 不输出、页面无响应。
- 必须显式调用
js.Wait()（推荐）或select{}，二者语义等价但前者更清晰 - 不能用
time.Sleep(1 * time.Hour)，它底层转为js.Sleep，但不如js.Wait()明确表达“等待 JS 调用”意图 - 若提前 panic（比如访问空指针、调用未注册的 JS API），也会触发
Go program exited提示，需加defer func(){...}()捕获 - 所有暴露给 JS 的函数必须在
js.Wait()前注册，例如：js.Global().Set("add", js.FuncOf(...))
浏览器加载失败的三个硬性前提
即使代码和胶水都对，本地开发仍常卡在环境层面：file:// 协议被禁、MIME 类型缺失、路径错误。这不是 Go 的问题，是浏览器安全策略。
- 绝对不要双击 HTML 文件——必须用 HTTP 服务，例如：
go run -m ./server.go或npx serve -s - 服务器必须返回
Content-Type: application/wasm，Python 的http.server默认不支持，Chrome 会拒绝加载 -
fetch("main.wasm")路径必须相对于 HTML 当前 URL，常见错误是写成./dist/main.wasm但 HTML 在根目录 - 典型加载代码必须按顺序执行：
const go = new Go(); WebAssembly.instantiateStreaming(fetch("main.wasm"), go.importObject).then(...)
最易被忽略的是胶水脚本和 Go 版本的绑定关系——哪怕只差一个小版本，wasm_exec.js 和 main.wasm 的导入导出表就可能不兼容，此时没有任何警告，只有控制台静默失败或奇怪的 LinkError。动手前先确认 go version 和 wasm_exec.js 来源是否完全一致。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
