<p>unikernel 中 C# 无传统 System.IO 文件系统，File.Exists 等调用抛 PlatformNotSupportedException；文件访问仅限编译期资源或显式挂载的 FS 驱动，须弃路径思维、用嵌入资源或 MemoryFileSystem。</p>
unikernel 环境下 C# 根本没有 System.IO 的传统文件系统抽象
在 unikernel（比如 MirageOS、IncludeOS 或 Unikraft 上运行的 C# 运行时）中，File.Exists、Directory.GetFiles 这类调用大概率直接抛出 PlatformNotSupportedException 或静默失败。原因很简单：unikernel 没有“操作系统内核”来提供 POSIX 文件接口，也没有全局路径命名空间——它只有你显式链接进去的驱动和资源。
常见错误现象：UnauthorizedAccessException 却没开权限、DirectoryNotFoundException 但路径明明写对了、FileStream 构造成功却读不出字节。
- 所有文件访问必须基于编译期确定的只读资源（如嵌入的
initrd镜像）或运行时注入的内存块 - 没有
C:\或/tmp这种隐式根；路径解析由你绑定的 FS 驱动决定（例如fat32驱动只认 FAT 表结构） -
System.IO.FileSystemNuGet 包在这里不生效——它依赖libuv或 Win32 API，而 unikernel 没这两样
用 Microsoft.DotNet.Interactive.Filesystem？别试了，它不支持 unikernel
这个包是为 .NET Interactive Notebook 设计的模拟层，底层仍走 System.IO。在 unikernel 中加载会触发 JIT 失败或类型初始化异常（TypeInitializationException），因为它的静态构造器尝试访问 Environment.GetFolderPath。
真正可用的路径操作仅限于：编译时已知的资源 + 显式挂载的 FS 驱动 + 手动实现的 IFileSystem 接口。
- 如果你用的是
Uno.Wasm.Bootstrap或AOT-compiled CoreRT变体，检查是否启用了System.IO.FileSystem.IsSupported—— 它几乎总是false - 替代方案不是“换一个库”，而是放弃路径思维：把配置当常量字符串传入，把模板文件打包成
byte[]嵌入程序集，用Assembly.GetManifestResourceStream读取 - 若必须动态加载，得自己实现一个
MemoryFileSystem，用ConcurrentDictionary<string byte></string>模拟目录树，再把它注入到业务逻辑里
轻量虚拟机（如 QEMU + ukvm）里，C# 的文件 I/O 性能瓶颈不在磁盘，而在驱动桥接层
即使你成功挂载了 FAT32 镜像，每次 FileStream.Read 调用都会触发一次完整的 trap → host → vmm → guest ring0 → 驱动回调链。这比 Linux 下的 read(2) 慢 10–100 倍，且无法用 Span<byte></byte> 零拷贝优化——因为 unikernel 的内存页通常不可跨上下文共享。
典型性能陷阱：StreamReader.ReadLine() 在 unikernel 中可能比等长的 for 循环还慢，因为它内部做了多次小 buffer 分配和编码探测。
- 优先用一次性读取：
stream.ReadExactly(buffer)（需System.Memory5.0+）代替循环Read - 禁用所有编码自动探测：明确指定
Encoding.UTF8，避免StreamReader调用DetectEncoding - 如果文件内容固定，干脆在构建阶段生成 C# 类型（类似
resx编译），绕过运行时 I/O
最容易被忽略的一点：unikernel 的“当前目录”概念根本不存在
没有 Environment.CurrentDirectory，没有 AppContext.BaseDirectory 的可靠值，Assembly.Location 返回空字符串或占位符。所有相对路径解析都由你选的 FS 驱动定义，而多数驱动根本不实现相对路径解析——只接受绝对路径如 /config.json，且该路径必须在镜像构建时就存在。
这意味着：任何硬编码 "./data" 或 Path.Combine("data", "user.db") 的代码，在 unikernel 中等于随机失败。
- 所有路径必须来自配置参数（如启动命令行传入
--rootfs=/dev/sda1），不能靠反射或环境推导 - 不要依赖
Assembly.GetExecutingAssembly().Location获取资源位置——它在 AOT 模式下返回空 - 如果要用 JSON 配置，别用
JsonSerializer.DeserializeAsync<fileconfig>(stream)</fileconfig>，改用JsonSerializer.Deserialize<fileconfig>(span)</fileconfig>直接喂入预读的ReadOnlySpan<byte></byte>
