syscall/js 不能直接调用 Go 的 main 函数，因为 main 不是 WASM 入口点，而是被 runtime 拦截为异步事件循环起点；main 必须阻塞（如用 js.Wait()），否则实例退出导致 JS 回调失效。
为什么 syscall/js 不能直接调用 Go 的 main 函数
Go 编译 WebAssembly 时，main 函数不是入口点——它只是被 syscall/js 的运行时拦截并转为异步事件循环的起点。你写 func main() { ... }，实际执行的是 js.Set("myFunc", js.FuncOf(...)) 这类注册逻辑，而不是传统意义上的“启动即跑完”。一旦 main 返回，WASM 实例就静默退出，所有注册的 JS 回调失效。
常见错误现象：Uncaught RuntimeError: unreachable 或 JS 调用 Go 函数时无响应，往往是因为 main 提前结束了，没用 select {} 或 js.Wait() 阻塞住。
-
main必须阻塞，推荐用js.Wait()（Go 1.19+）或select {}（兼容旧版） - 不要在
main里直接写业务逻辑，应封装为js.FuncOf后挂到全局对象上 - 如果用了
go mod，确保GOOS=js GOARCH=wasm go build，且目标文件是.wasm，不是可执行文件
如何从 JS 正确加载并初始化 Go 编译出的 main.wasm
Go 输出的 WASM 不是自执行模块，它依赖 syscall/js 提供的胶水代码（runtime.js），必须配合使用。直接 fetch().then(WebAssembly.instantiateStreaming) 会失败，因为缺少符号绑定和内存初始化。
使用场景：前端构建流程中集成 Go WASM，比如 Vite 或 Webpack 项目里想复用 Go 的加密或解析逻辑。
立即学习“go语言免费学习笔记（深入）”；
- 必须通过 Go 官方生成的
main.wasm+wasm_exec.js配合加载（路径需一致） -
wasm_exec.js来自$GOROOT/misc/wasm/wasm_exec.js，不能用 CDN 或自行压缩，否则函数签名不匹配 - JS 加载代码里要等
wasm_exec.js执行完再调用instantiateStreaming，否则global.Go未定义 - 示例关键片段：
const go = new Go(); await webAssembly.instantiateStreaming(fetch("main.wasm"), go.importObject); go.run(instance);
js.Value 和 js.Func 的类型转换容易踩哪些坑
js.Value 是 JS 对象在 Go 中的抽象，但它是引用传递、不可拷贝、不支持并发访问。很多 panic 源于误以为它像普通 struct 一样能随便传参或保存。
性能影响：频繁调用 js.Global().Get("xxx") 或反复 .Call() 会有明显开销，尤其在动画帧或高频事件中。
- 不要把
js.Value存在全局变量或结构体字段里——它可能在 JS 垃圾回收后失效，下次访问 panic “invalid memory address” - 回调函数里用
js.FuncOf创建的js.Func必须手动.Release()，否则内存泄漏（浏览器不会自动回收） - JS 传来的数组/对象，用
v.Length()或v.Get("length")前先v.IsNull() || v.IsUndefined()判空 - Go 字符串转
js.Value用js.ValueOf("str")，但大文本建议用Uint8Array+js.CopyBytesToJS避免重复编码
编译参数和构建产物怎么配才不出错
Go 的 WASM 编译不是“换个 GOOS 就行”，环境变量、工具链版本、输出路径三者不一致，轻则 undefined symbol: runtime.nanotime1，重则 JS 里 Go 构造函数不存在。
兼容性影响：Go 1.21 默认启用 zlib 压缩 wasm，但某些老版 nginx 不支持 Content-Encoding: br，导致加载失败。
- 编译命令固定为：
GOOS=js GOARCH=wasm go build -o main.wasm main.go，不能加-ldflags="-s -w"（会剥离必要符号） -
main.go必须是 packagemain，且含func main()；其他包无法直接暴露给 JS - 构建产物
main.wasm和wasm_exec.js必须同目录，或按wasm_exec.js里const wasmPath = "main.wasm"的路径约定调整 - 开发时用
http.ServeFile起个静态服务，别用 VS Code Live Server——它不支持application/wasmMIME 类型
