能否用.NET 8创建无依赖的纯WASM模块？

可行性确认 #

完全可行。借助.NET 8的wasm-tools工作负载，你可以编译出不依赖WASI、浏览器API或其他外部接口的纯WASM模块，适合用于侧载更新的独立业务逻辑单元。关键是要避免使用wasmconsole或wasmbrowser这类自带环境依赖的模板，转而自定义类库项目并配置编译参数，剔除不必要的依赖项。

导出C#函数至WASM模块的方法 #

要将C#函数导出为WASM可调用的外部函数，需遵循以下规则：

• 使用[UnmanagedCallersOnly(EntryPoint = "导出名")]特性标记静态方法，指定WASM中暴露的函数名
• 函数的参数和返回值必须是** blittable 类型**（如int、long、float、bool等值类型，不能使用托管对象、字符串或复杂引用类型）
• 确保项目配置中禁用WASI和浏览器相关依赖

复现gcd.wat的最小C#可运行示例 #

1. 创建项目 #

创建一个类库项目（而非控制台/浏览器模板）：

dotnet new classlib -n WasmGcdDemo
cd WasmGcdDemo

2. 修改项目配置（WasmGcdDemo.csproj） #

添加必要的编译配置，确保生成无依赖的纯WASM模块：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <OutputType>Library</OutputType>
    <!-- 禁用WASI支持 -->
    <EnableWasi>false</EnableWasi>
    <!-- 使用全球化不变模式，减少依赖 -->
    <InvariantGlobalization>true</InvariantGlobalization>
    <!-- 生成单文件WASM包 -->
    <WasmSingleFileBundle>true</WasmSingleFileBundle>
    <!-- 剥离无用的原生符号，减小体积 -->
    <WasmNativeStrip>true</WasmNativeStrip>
  </PropertyGroup>

  <ItemGroup>
    <!-- 引入.NET WASM编译SDK -->
    <PackageReference Include="Microsoft.NET.Runtime.WebAssembly.Sdk" Version="8.0.0" PrivateAssets="all" />
  </ItemGroup>
</Project>

3. 编写导出函数代码 #

替换Class1.cs为以下内容，实现GCD算法并导出为WASM函数：

using System.Runtime.InteropServices;

public static class WasmMathExports
{
    // 导出为WASM中的"gcd"函数
    [UnmanagedCallersOnly(EntryPoint = "gcd")]
    public static int ComputeGcd(int a, int b)
    {
        while (b != 0)
        {
            int temp = b;
            b = a % b;
            a = temp;
        }
        return a;
    }
}

4. 编译并验证 #

执行编译命令：

dotnet build /p:Configuration=Release

编译完成后，在bin/Release/net8.0/bundles/default目录下会生成WasmGcdDemo.wasm文件。你可以用wasm-tools inspect工具验证导出的函数：

wasm-tools inspect bin/Release/net8.0/bundles/default/WasmGcdDemo.wasm --exports

输出会包含gcd函数，且模块不会依赖WASI或浏览器相关的外部函数，完全符合你的需求。

侧载更新的适配建议 #

生成的纯WASM模块体积小、无依赖，宿主应用可以通过网络下载该模块文件，使用.NET的WASM运行时或第三方WASM执行引擎加载并调用导出的函数，实现业务逻辑的独立更新。

内容的提问来源于stack exchange，提问作者Robert Schmid