syscall/js是go与webassembly前端交互的唯一官方标准路径，所有正确用法均需遵循其约束：js.funcof回调必须显式传参、不能依赖闭包；select{}必须作为main()最后语句阻塞主线程以维持实例生命周期，否则js回调失效。
syscall/js 是 Go 与 WebAssembly 前端交互的唯一标准路径，没有“替代方案”或“更高级封装”——它就是 Go 官方提供的、且目前唯一被维护的桥梁。所有所谓“优雅”，都建立在正确理解它的约束和惯用法之上。
为什么 js.FuncOf 必须显式传参且不能闭包捕获变量
常见错误：在 js.FuncOf 回调里直接引用外部变量（比如 config 或 cache），结果运行时报 panic: runtime error: invalid memory address 或返回 undefined。
根本原因：Wasm 沙箱不共享 Go 的堆栈上下文，js.FuncOf 创建的函数是 JS 侧触发的独立调用入口，Go 运行时不会为你保留闭包环境。
正确做法：
- 所有参数必须通过
args []js.Value显式传入，哪怕只是个 ID 或 flag - 需要持久状态的，改用
js.Global().Get("someObj")读取 JS 全局对象，或提前用js.Global().Set("state", js.ValueOf(...))写入 - 若需复用逻辑，封装成普通 Go 函数，再在
js.FuncOf回调里调用它，而非把它本身塞进闭包
select{} 不是占位符，而是阻塞主线程的关键开关
新手常误以为 select{} 只是防止程序退出的“空循环”，其实它承担着维持 Wasm 实例生命周期的实质作用。
一旦主线程退出，整个 Go 运行时（包括 js.FuncOf 注册的函数）会被销毁，JS 再调用就会报 TypeError: add is not a function。
注意点：
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 不能用
time.Sleep替代 —— 它会阻塞但不保持事件循环活跃，JS 调用可能无法送达 - 不能放在
main()外部（比如 defer 后）—— 它必须是main()的最后一条语句 - 如果要响应 JS 通知后退出，得用
js.ChanOf+case 配合 <code>runtime.Goexit()，而不是简单 break
字符串和 slice 传递必须手动转换，没有自动 marshal
Go 的 string、[]byte、[]int 传给 JS 时不会自动转成 JS 的 String 或 ArrayBuffer，反之亦然。
典型错误：直接 return []int{1,2,3}，JS 侧收到的是 Object，length 为 0，遍历为空。
正确转换方式：
- Go → JS 字符串：
js.ValueOf("hello").String()不行；要用js.ValueOf("hello")直接返回，JS 侧拿到的就是 string - Go → JS 数组：
js.ValueOf([]int{1,2,3})返回的是 JS object，需改用js.ArrayOf(1,2,3) - JS → Go 字符串：
args[0].String()可以；但args[0].Str()不存在，别拼错 - JS → Go Uint8Array：
js.CopyBytesToGo(dst, args[0])，dst 必须是预分配的[]byte
wasm_exec.js 不是可选依赖，而是运行时必需胶水
很多人尝试删掉 wasm_exec.js，改用原生 WebAssembly.instantiateStreaming 加载，结果 syscall/js 功能全部失效（js.Global() 为空、js.FuncOf 报 panic）。
原因：这个文件不是“加载器”，而是 Go Wasm 运行时的 JS 侧实现，负责桥接内存、调度 goroutine、转发 JS 调用到 Go 函数。
使用要点：
- 必须从
$GOROOT/misc/wasm/wasm_exec.js复制，不能自己写或 npm install 替代 - 路径必须与
fetch('main.wasm')对齐，否则go.run()初始化失败 - 若用构建工具（Vite/Webpack），需确保它被当作普通 script 加载，而非模块化处理 —— 它依赖全局
Go构造函数
js.Value 的生命周期管理：它背后绑定的是 Wasm 线性内存中的一块 JS 引用，一旦 Go 函数返回，这些引用就可能被 GC 回收。如果你在回调里保存了 args[0] 到全局变量，下次 JS 再调用时访问它，大概率得到 null 或崩溃。需要长期持有的，必须用 js.CopyBytesToGo 或 js.Value.Call("slice") 显式复制数据。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
