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语言免费学习笔记（深入）”；

Colly Golang Web Scraper and Crawler Framework

Colly 是一个用于 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 必须是 package main，且含 func main()；其他包无法直接暴露给 JS
• 构建产物 main.wasm 和 wasm_exec.js 必须同目录，或按 wasm_exec.js 里 const wasmPath = "main.wasm" 的路径约定调整
• 开发时用 http.ServeFile 起个静态服务，别用 VS Code Live Server——它不支持 application/wasm MIME 类型

事情说清了就结束。最常被忽略的是：Go WASM 不是“另一个 JS 库”，它自带运行时、GC 和调度器，JS 侧任何对它的调用都得绕过这层抽象——你以为在调函数，其实是在触发一次跨语言事件循环。