UD5工具箱
Go WebAssembly相关术语表
WebAssembly（WASM）
WebAssembly是一种低级的、基于栈的虚拟机指令格式，设计为编程语言的可移植编译目标。它允许使用C、C++、Go、Rust等语言编写的程序在Web浏览器中以接近原生的速度运行。WASM文件以二进制格式存储，包含类型化的指令集、内存模型和导入导出声明。浏览器通过WebAssembly JavaScript API加载和执行WASM模块，模块可以与JavaScript代码互操作。WASM的出现填补了JavaScript在计算密集型任务上的性能短板，使Web平台能够运行更复杂的客户端应用。
Go WASM编译目标
Go语言的WASM编译通过设置环境变量GOOS=js和GOARCH=wasm实现。编译器将Go源代码编译为.wasm格式的二进制文件，同时生成一个JavaScript桥接文件wasm_exec.js，该文件实现了Go运行时与JavaScript之间的通信层。Go WASM模块在浏览器的JavaScript执行环境中运行，通过syscall/js包提供的API访问浏览器功能。Go的垃圾回收器、调度器和标准库的大部分功能在WASM环境中都能正常工作，使得Go程序可以无缝迁移到浏览器平台。
syscall/js包
syscall/js是Go标准库中专门用于Go WASM开发的包，提供了与JavaScript运行时交互的底层API。核心类型js.Value代表JavaScript值的引用，支持各种JavaScript数据类型（数字、字符串、布尔值、对象、数组、函数）的Go表示。js.Global()函数返回JavaScript全局对象（window）的引用，通过Get、Set、Call等方法可以访问JavaScript对象的属性和方法。js.FuncOf函数创建Go函数到JavaScript函数的包装器，用于注册事件处理器和回调函数。该包还提供了js.CopyBytesToGo和js.CopyBytesToJS函数用于在Go和JavaScript之间高效传输二进制数据。
wasm_exec.js
wasm_exec.js是Go编译器自动生成的JavaScript桥接脚本，实现了Go运行时环境与JavaScript宿主环境之间的通信层。该脚本定义了GoWASM实例的加载、初始化和执行流程，包括内存分配、垃圾回收调度、goroutine管理等运行时服务。wasm_exec.js还实现了标准输入输出的重定向，将Go程序的fmt.Print等输出捕获后转发到浏览器的console.log。该文件必须与.wasm文件一起部署，HTML加载页面需要在加载WASM模块前引入该脚本。不同Go版本生成的wasm_exec.js可能不兼容，需要与编译WASM时使用的Go版本匹配。
TinyGo
TinyGo是一个针对小型平台优化的Go编译器，支持生成体积更小的WebAssembly文件。与标准Go编译器相比，TinyGo通过裁剪未使用的标准库功能、简化垃圾回收器实现、优化二进制编码等方式，可以将WASM文件大小从几MB缩减到几十KB。但TinyGo对Go语言特性的支持不如标准编译器完整，某些标准库包和语言特性可能不可用。在选择使用标准Go还是TinyGo编译WASM时，需要根据项目的具体需求进行权衡：对文件大小敏感的项目（如需要快速加载的Web应用）适合使用TinyGo，需要完整Go语言特性的项目则应使用标准编译器。
JavaScript互操作（Interop）
JavaScript互操作是指Go WASM代码与浏览器JavaScript环境之间的双向通信能力。Go代码可以通过syscall/js包调用任何JavaScript函数、访问任何JavaScript对象属性、创建和操作JavaScript值。反过来，JavaScript代码也可以调用从Go导出的函数。互操作的边界处需要进行类型转换：Go的字符串需要转换为JavaScript字符串，JavaScript的数组需要逐元素复制到Go切片中。这种跨语言调用有一定的性能开销，频繁的Go-JS边界切换会影响整体执行效率。合理的架构设计应该尽量减少跨边界的调用次数，将相关逻辑集中在一侧执行。
Goroutine
Goroutine是Go语言的轻量级协程实现，由Go运行时调度器管理。在标准Go环境中，goroutine由操作系统线程支撑，可以实现真正的并行执行。在WASM环境中，由于浏览器的单线程限制，goroutine由JavaScript事件循环协作式调度，无法实现真正的并行。Go的WASM调度器在每次JavaScript事件循环迭代中轮转执行各个goroutine，使用协作式让出机制（如channel操作、函数调用等）进行切换。这意味着在WASM中，CPU密集型的goroutine可能会阻塞其他goroutine的执行，需要开发者注意避免长时间占用执行权。
js.Value类型
js.Value是syscall/js包中的核心类型，代表一个JavaScript值的引用。它封装了JavaScript值的类型信息和数据指针，提供了类型检查（Type方法）、属性访问（Get和Set方法）、方法调用（Call方法）等操作。js.Value支持的JavaScript类型包括：undefined、null、布尔值、数字、字符串、符号、对象、函数和数组。Go与js.Value之间的类型转换通过特定函数完成：js.ValueOf将Go值转换为js.Value，js.Global().Get("Number").New()将Go数字包装为JavaScript Number对象。js.Value采用引用语义，多个Go变量可以指向同一个JavaScript对象，修改会相互影响。
WASI（WebAssembly System Interface）
WASI是一套标准化的WebAssembly系统接口规范，旨在为WASM模块提供可移植的系统级功能访问。与Go WASM（GOOS=js）在浏览器JavaScript环境中运行不同，WASI设计用于在独立的WASM运行时（如Wasmtime、Wasmer）中执行，提供文件系统访问、网络套接字、环境变量等操作系统级别的功能。Go语言通过wasi_preview1编译目标支持WASI输出，使用标准库的os、net等包即可编写WASI兼容的程序。WASI的出现使WebAssembly从浏览器技术扩展到服务端和边缘计算领域，Go WASM和WASI分别代表了WASM在客户端和服务端的两种应用方向。
GopherJS
GopherJS是一个将Go代码编译为JavaScript的转译器，在WebAssembly出现之前是Go语言在浏览器中运行的主要方案。GopherJS将Go源代码转换为等效的JavaScript代码，然后在浏览器的JavaScript引擎中执行。与Go WASM相比，GopherJS生成的JavaScript文件通常更小，加载速度更快，但运行性能较低，因为JavaScript引擎无法像WASM虚拟机那样高效执行类型化的指令。Go WASM的出现逐渐取代了GopherJS的主流地位，因为WASM提供了更好的性能和更完整的Go语言特性支持。GopherJS项目目前处于维护状态，新项目建议优先选择Go WASM方案。