C# WebAssembly 仅支持 wit-bindgen 生成的单 world、无 resource 的 WIT 接口；需手动配置 WitBindgen.CSharp 包、指定 WitSourceFile，并用 [UnmanagedCallersOnly] 导出 ABI 兼容函数。
WIT 文件里怎么写接口才能被 C# WebAssembly 正确识别
WIT（WebAssembly Interface Types）文件不是随便写的 IDL，C# WebAssembly 当前只支持 wit-bindgen 生成的、符合 Component Model 规范的 WIT 接口，且必须是「单 world」+「无资源（resource）」的简单函数导出。如果你写了 resource handle 或用了 use 引入外部 world，wit-bindgen-csharp 会静默跳过或生成编译错误，但不会告诉你为什么。
实操建议：
- 用
world块包裹所有导出，不要嵌套package或interface—— C# 工具链目前不解析多层命名空间 - 函数参数和返回值只用基础类型：
s32,string,list u8；避免record,variant,enum（除非你手动补全Bindgen的 type mapping） - 文件扩展名必须是
.wit，且路径不能含空格或中文，否则wit-bindgen-csharp在 MSBuild 中读取失败时只报MSB3073错误，不提示具体路径问题
dotnet build 时怎么让 WIT 自动生成 C# 绑定类
不是加个 NuGet 就能自动工作。C# WebAssembly 对 WIT 的支持依赖 wit-bindgen-csharp CLI 工具 + MSBuild 集成，而官方 SDK（.NET 8+）默认不启用它，必须手动配置。
实操建议：
- 在项目文件中添加
<packagereference include="WitBindgen.CSharp" version="0.16.0"></packagereference>（注意版本号要和你的wit-component工具链匹配） - 在
<propertygroup></propertygroup>里显式设置<witsourcefile>path/to/your.world.wit</witsourcefile>，不能靠 glob 自动发现 - 确保
wit-componentCLI 已安装并可在PATH中调用，否则构建会卡在GenerateWitBindingstarget 并报The command "wit-bindgen-csharp" exited with code 9009
C# 实现的 WASM 组件如何被 Rust/JS 调用而不崩溃
关键不在 C# 代码本身，而在导出方式 —— .NET 的 WebAssembly AOT 编译器默认不导出托管函数为 WASM 的 func，而是走 JS interop 层。想被其他语言直调，必须用 [UnmanagedCallersOnly] + 手动暴露 ABI 兼容签名，且不能引用任何 GC 对象。
实操建议：
- 导出函数签名只能是
void*,int,byte*这类非托管类型；字符串要用IntPtr+Marshal.PtrToStringUTF8手动转换 - 禁用所有 async/await 和 LINQ —— AOT 下
Task不可序列化，Enumerable.Where会被裁剪掉导致MissingMethodException - 发布时用
dotnet publish -c Release -r wasm -p:PublishAot=true，漏掉-p:PublishAot=true会导致生成的是 interpreter 模式组件，无法被其他语言作为 Component 加载
“找不到入口函数”或 “component type mismatch” 是哪出错了
这两类错误几乎都指向 WIT 和实际导出的 ABI 不对齐：要么 WIT 声明了函数但 C# 没用 [UnmanagedCallersOnly] 导出，要么导出名大小写/参数顺序和 WIT 定义不一致。WASM Component 模型比传统 WASM 更严格，函数名必须完全匹配，且没有重载。
实操建议：
- 用
wit-component inspect your.wasm查看实际导出的 component 类型，对比 WIT 文件里的world名称是否一致（包括大小写） - 检查 C# 函数名是否和 WIT 中定义的完全相同，例如 WIT 写的是
process_data，C# 就不能写成ProcessData或processData - 如果用
wit-component new封装了多个 wasm 文件，确认主组件确实引用了你的 C# 导出模块，而不是只打包了空壳
最常被忽略的一点：WIT 的 world 名称和最终生成的 .wasm 文件名无关，但和 wit-component 解析时的 module name 绑定。改了 WIT 里的 world 名，不清理 obj/ 目录就重编译，旧缓存 binding 会继续生效，错误表现就是“明明改了却还报老错”。
