需升级go至1.12+，确认goroot路径并复制wasm_exec.js，main中必须调用js.wait()，且须通过http服务器而非file://协议访问。
GOOS=js GOARCH=wasm 报 build constraints exclude all Go files 怎么办
这是环境没配对的典型信号，不是代码问题。Go 1.11 起才带 wasm 构建支持，但真正稳定要到 go1.12+；低于这个版本，syscall/js 包压根不存在，自然所有文件被构建约束排除。
- 先跑
go version确认——输出是go1.10.8或更老？必须升级，别挣扎 - Mac M1/M2 用户注意：用 Homebrew 装的 Go 很可能还是旧版，优先从 go.dev 下载官方
arm64二进制安装 - Windows + WSL 场景下，确保宿主机（不是 WSL 里）装的是新版 Go，因为最终 wasm 是在浏览器跑，和 WSL 无关
- 如果版本没问题还报错，检查是否误删了
$GOROOT/src/syscall/js目录——极少见，但重装 Go 最快
wasm_exec.js 找不到或用了就报 ReferenceError: Go is not defined
wasm_exec.js 不是生成的，是 Go 安装自带的胶水脚本，必须手动复制，且版本强绑定。用错版本会导致 JS 侧 new Go() 失败，或 Go 侧 panic bad callback signature。
- 正确路径永远是：
$(go env GOROOT)/misc/wasm/wasm_exec.js，用cp复制到项目根目录（和index.html同级） - 别搜网上“wasm_exec.js 教程下载”，2023 年前的老版本和
go1.19+的syscall/jsABI 不兼容 - 如果你用
gvm或asdf管理多版本 Go，务必先go env GOROOT查清当前激活版本的路径再拼
main.go 编译后页面没反应，JS 调用 Go 函数报 TypeError: xxx is not a function
Go 的 wasm 主 goroutine 退出 = 整个实例销毁。你注册的 js.Global().Set("add", ...) 全部失效，但 JS 不报错，只静默失败。
- 必须在
main()最后加js.Wait()（Go 1.19+ 推荐），不能用select {}或time.Sleep替代——它们不响应 JS 事件循环 - 函数体里别提前 return，也别让 main() 自然结束；哪怕只暴露一个函数，也要阻塞住
- 示例最小结构：
package main
import "syscall/js"
func add(this js.Value, args []js.Value) interface{} {
return args[0].Int() + args[1].Int()
}
func main() {
js.Global().Set("add", js.FuncOf(add))
js.Wait() // ← 这行不能少，也不能放错位置
}
浏览器打开 index.html 提示 net::ERR_FILE_NOT_SUPPORTED 或 wasm 加载失败
WASM 模块必须通过 HTTP 协议加载，浏览器禁止 file:// 协议读取 .wasm 文件，这是硬性安全策略，和代码无关。
- 别双击打开 HTML，用轻量 HTTP 服务启动：比如
npx http-server、python3 -m http.server 8080，或 VS Code 插件 Live Server - 确保响应头含
Content-Type: application/wasm；Python 自带服务器默认不设，会出错；http-server默认支持 - Chrome/Firefox 都行，但 Safari 对早期 wasm 特性支持略保守，开发阶段建议主力用 Chrome
wasm_exec.js 是唯一可信桥梁，js.Wait() 是唯一存活机制——漏掉任一环，整个交互就断在看不见的地方。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
