在浏览器外的WASI（WebAssembly System Interface）环境中，C#编译的WebAssembly模块运行在受沙箱限制的系统接口层，默认无法直接访问宿主机的任意文件，需要通过预授权的目录映射和标准的WASI文件API实现本地文件的读写操作。
WASI文件访问的核心机制
WASI为WebAssembly模块提供了一套安全的系统接口，文件访问遵循最小权限原则。宿主运行时会通过目录预授权的方式，指定WebAssembly模块可以访问的宿主目录，模块只能操作被授权目录下的文件，无法直接访问整个文件系统。
当使用C#编写WASI目标程序时，需要借助支持WASI的.NET运行时，目前主流的方案是使用.NET NativeAOT配合WASI SDK，或者基于WasmTime等运行时加载编译后的WASM模块。
环境准备步骤
- 安装.NET 8及以上版本SDK，确保支持NativeAOT编译
- 安装WASI SDK，用于提供WASI兼容的编译工具链
- 安装WasmTime运行时，用于本地测试WASI模块
- 配置项目文件，指定WASI为目标运行时
项目配置示例
创建控制台项目后，修改csproj文件添加WASI相关配置：
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net8.0</TargetFramework>
<RuntimeIdentifier>wasi-wasm</RuntimeIdentifier>
<PublishAot>true</PublishAot>
<WasmEnableExceptionHandling>true</WasmEnableExceptionHandling>
</PropertyGroup>
</Project>
文件读取实现
WASI环境下的文件读取需要通过System.IO命名空间下的标准API，前提是宿主运行时已经将目标目录授权给WASM模块。假设宿主将本地/data目录映射到WASM模块的/mnt目录，读取该目录下test.txt文件的代码如下：
using System;
using System.IO;
class Program
{
static void Main()
{
// 被授权的目录下的文件路径，对应宿主的/data/test.txt
string filePath = "/mnt/test.txt";
try
{
// 检查文件是否存在
if (File.Exists(filePath))
{
// 读取文件全部内容
string content = File.ReadAllText(filePath);
Console.WriteLine($"读取到的文件内容：{content}");
}
else
{
Console.WriteLine("目标文件不存在，请检查目录授权是否正确");
}
}
catch (Exception ex)
{
Console.WriteLine($"读取文件失败：{ex.Message}");
}
}
}
文件写入实现
文件写入的逻辑与读取类似，同样需要操作被授权目录下的路径，以下示例实现向授权目录写入新文件的功能：
using System;
using System.IO;
class Program
{
static void Main()
{
// 写入目标路径，对应宿主的/data/output.txt
string filePath = "/mnt/output.txt";
string content = "这是C# WASI程序写入的测试内容";
try
{
// 写入文件，如果文件不存在会自动创建
File.WriteAllText(filePath, content);
Console.WriteLine($"文件写入成功，路径：{filePath}");
}
catch (Exception ex)
{
Console.WriteLine($"写入文件失败：{ex.Message}");
}
}
}
模块运行与权限配置
编译项目后，使用WasmTime运行WASM模块时，需要通过--dir参数指定目录映射，将宿主目录授权给WASM模块：
# 编译项目为WASI目标 dotnet publish -c Release -r wasi-wasm # 运行模块，将宿主当前目录下的data文件夹映射到WASM的/mnt目录 wasmtime --dir data::/mnt bin/Release/net8.0/wasi-wasm/publish/项目名.wasm
上述命令中data::/mnt表示宿主的data目录对应WASM模块内的/mnt目录，模块只能操作该目录下的文件。
常见问题排查
- 如果提示文件不存在，首先检查
--dir参数映射的目录是否正确，以及目标文件是否在映射目录下 - 如果遇到权限错误，确认运行时是否正确添加了目录授权，WASI默认不开放任何目录访问权限
- 如果代码编译失败，检查.NET SDK版本是否支持WASI目标，以及项目配置是否正确
注意事项
WASI的文件访问权限是静态预授权的，无法在运行时动态申请新的目录权限。如果需要访问多个目录，运行时要添加多个--dir参数。另外，不同WASI运行时的目录映射语法可能略有差异，需要参考对应运行时的官方文档调整参数。
C#WebAssemblyWASI文件读写宿主文件访问修改时间：2026-06-29 06:33:17