WIT 文件需通过 wit-bindgen 生成 C# 绑定代码才能使用，.NET 8+ WebAssembly 不直接解析 WIT；必须启用 WASI 和组件模型支持，并正确配置项目、引用生成代码及 native 资产。
WIT 文件不是 C# 原生支持的格式，必须通过 wit-bindgen 工具生成绑定
WIT（WebAssembly Interface Types）文件定义组件接口契约，但 .NET 8+ 的 WebAssembly AOT/LLVM 支持不直接解析 wit 文件。你不能用 File.ReadAllText 读完就调用——它只是描述，不是可执行代码。
真正能用的，是 wit-bindgen 生成的 C# 类型和互操作桩代码。这个步骤不可跳过，否则所有函数调用都会在运行时崩在 MissingMethodException 或 DllImport 解析失败上。
- 必须安装
wit-bindgenCLI（推荐 v0.29+，与wasm-tools兼容） - 目标语言选
csharp，不是dotnet或net - 生成命令示例：
wit-bindgen csharp --out-dir ./Generated --name mycomponent ./interfaces/mycomponent.wit - 生成后要把
./Generated下的.cs文件加入项目，且确保引用了Wasi.Sdk或Microsoft.AspNetCore.Components.WebAssembly.DevServer（取决于宿主）
生成的 C# 类型里没有自动内存管理，手动处理 string 和 list 的生命周期
wit-bindgen 输出的 C# 方法签名看着像普通函数，但底层走的是 WASI 或 Component Model 的线性内存协议。传入 string 不是复制字符串，而是写入模块内存并返回偏移；返回 list<u8></u8> 不是 byte[]，而是带长度+指针的结构体。
常见崩溃点：在回调中直接把 result.String 赋值给字段、或在 using 块里释放了本不该你管的内存。
- 所有生成的
String、List<t></t>字段都是只读快照，修改它们无效，也不该Marshal.FreeHGlobal - 如果需要长期持有，必须显式调用
result.String.ToString()（这是安全拷贝） - 对
list<i32></i32>这类，用result.List.ToArray()获取托管数组，别碰result.List.Ptr - 注意生成类里的
Dispose方法——它只清理本地分配的句柄，不负责 WASM 线性内存
在 Blazor WebAssembly 中调用组件，必须启用 WASI 或 ComponentModel 运行时支持
默认 Blazor WebAssembly 模板跑的是纯 .NET IL AOT，不加载 WASI 函数表，也不识别 .wasm 组件二进制格式。直接 new MyComponent() 会卡在 DllNotFoundException: wasi_snapshot_preview1。
这不是代码问题，是宿主没配对。.NET 8 的 WebAssembly 支持分两层：基础 WASI（用于 I/O）、组件模型（用于 .wit 接口驱动）。两者都要显式开启。
- 项目文件加
<wasmenablewasi>true</wasmenablewasi>和<wasmenablecomponentmodel>true</wasmenablecomponentmodel> -
Program.cs里注册组件工厂：builder.Services.AddSingleton<mycomponent>();</mycomponent>，但前提是组件 DLL 已通过<wasmnativeasset></wasmnativeasset>引入 - 组件二进制（如
mycomponent.wasm）必须放在wwwroot/_framework/native/下，并在index.html中用<script type="module"></script>加载 runtime 初始化逻辑 - 调试时留意浏览器控制台是否报
failed to instantiate component: invalid module——大概率是wit版本和生成器不匹配（比如用了 v2 WIT 语法但 bindgen 是 v0.28）
wit-bindgen 生成的命名空间和类名受 --name 和 WIT world 定义影响，别硬编码引用
生成的 C# 类不是固定叫 MyComponent。它由 wit 文件里的 package、world 和 --name 三者拼接决定。比如 package foo:bar; world myapp; + --name client，实际类名可能是 Foo.Bar.Myapp.Client。
很多团队直接按直觉命名空间去 using，结果编译不过，又回头翻生成代码——浪费时间。
- 生成后立刻检查输出目录下的
AssemblyInfo.cs或主入口类，确认顶层命名空间 - WIT 中
world块名必须和--name一致，否则生成的Host类无法匹配导入导出 - 如果 WIT 里用了
use引入外部接口（如wasi:http/types），确保对应wit文件已放在--world-path指定目录，否则生成器静默跳过，运行时报unknown interface - 别在生成代码里改类名——下次重生成就覆盖了。要用别名：
using MyComp = Foo.Bar.Myapp.Client;
事情说清了就结束。最常卡住的地方不在代码逻辑，而在 WIT 文件版本、bindgen 版本、.NET SDK 版本这三者的隐式耦合——差一个小版本，生成的互操作签名就对不上。
