tinygo build -target=wasi 是唯一能跑通 WASI 的路径，因 Go 官方不支持 WASI syscall 映射；必须用 tinygo v0.28.0+，配 -scheduler=none、-gc=leaking、-no-debug 等关键参数，并通过 wasmtime/wasmedge 验证。
tinygo build -target=wasi 是唯一能跑通的路径
Go 官方 go build 不支持 WASI 目标，无论加 -target=wasi 还是设 GOOS=wasip1 GOARCH=wasm，都会报错或生成无法加载的模块——这不是配置问题，是运行时根本没实现 WASI syscall 映射。tinygo 自研轻量运行时能将 os.Args、os.ReadFile、fmt.Println 等映射到 WASI ABI（如 args_get、path_open、fd_write），这是它不可替代的核心能力。
- 必须用
tinygo v0.28.0+，旧版对 WASI Preview 1 支持不全 - 不能靠
//go:build wasi或replace在 go.mod 里“绕过”官方工具链——无效 -
GOOS=js GOARCH=wasm编译出的是浏览器专用 wasm，依赖syscall/js和胶水 JS，进不了wasmtime或wasmedge
关键编译参数不加就卡死或 panic
WASI 没有线程、定时器、信号机制，tinygo 默认行为在 WASI 下多数失效。几个 flag 不是可选优化，而是运行前提：
-
-scheduler=none：禁用 goroutine 调度器，否则go func()、time.Sleep、select{}全部静默失败或 panic；main 函数退出即进程终止 -
-gc=leaking：关闭 GC，避免 conservative GC 在无 mmap/mprotect 的 WASI 环境下崩溃；适合 CLI 工具类短生命周期程序 -
-no-debug：移除 DWARF 调试信息，某些运行时（如早期 wasmer）会因解析失败拒绝加载 - 不支持
net/http、crypto/tls、plugin，这些包底层调用 POSIX socket 或 dlopen，WASI 无对应接口
导出函数必须用 Reactor 模式 + wasi_start
默认 tinygo 编译出的是 “command” 模块：启动 → 执行 main → 退出。若想被多次调用（比如作为 CLI 工具库嵌入其他系统），得切到 Reactor 模式，并手动处理初始化逻辑：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 加
-tags=reactor编译，触发 tinygo 生成_start和wasi_start符号，而非直接跳转main - main 函数不能阻塞（别写
select{}），应尽早返回；状态需存在全局变量或通过unsafe指针管理 - 函数导出要靠
//go:wasmexport注释，且必须是包级函数（不能是方法），例如：//go:wasmexport add+func add(a, b int32) int32 - WASI 运行时（如
wasmtime）会自动调用wasi_start，但不会帮你调main—— 这正是 Reactor 和 Command 的分水岭
验证和调试必须用 WASI 运行时，不能靠浏览器
编译出的 .wasm 文件不是浏览器能加载的格式，也不能双击运行。验证是否真兼容 WASI，只能靠标准 WASI 运行时：
立即学习“go语言免费学习笔记（深入）”；
- 推荐
wasmtime（v20+）或wasmedge（v0.14+），执行命令统一为：wasmtime run --dir=. your.wasm arg1 arg2 -
--dir=.是关键：WASI 默认禁止文件访问，必须显式授予权限才能读写当前目录 - 常见错误
error: failed to invoke command default: unreachable，大概率是漏了-scheduler=none或用了不支持的包 - 调试时加
--debug（wasmtime）或-V（wasmedge）看 syscall trace，重点检查args_get、fd_write是否被正常调用
WASI 不是“换个 target 就能跑”的编译选项，它是整套系统调用契约。tinygo 的每个 flag 都在对齐这个契约，跳过任意一个，模块就只是字节码，不是可执行单元。
