Avalonia 中读取本地文件依赖 System.IO，需确保路径正确（推荐 appContext.BaseDirectory）、权限合理，并避免阻塞 ui 线程；小文件用 File.ReadAllText，大文件用 Filestream 分块读取，用户选择文件必须用 OpenFileDialog，耗时操作需异步执行。
在 Avalonia 中读取本地文件，和标准 .NET 的文件操作基本一致，因为 Avalonia 本身不提供额外的文件 I/O API，而是依赖 System.IO（如 File.ReadAllText、FileStream 等）。关键在于：路径要正确、权限要合理、UI 线程不能被阻塞。
使用 System.IO 直接读取文本文件
这是最常用的方式，适合配置文件、日志、jsON 等小到中等体积的文本内容。
- 用
File.ReadAllText(path)一行读取全部内容（自动处理编码，推荐 UTF-8） - 若需指定编码，用
File.ReadAllText(path, Encoding.UTF8) - 路径建议用绝对路径或通过
AppContext.BaseDirectory构建相对路径，避免因工作目录不确定导致失败 - 示例：String content = File.ReadAllText(Path.Combine(AppContext.BaseDirectory, “config.json”));
安全选择文件路径：用 OpenFileDialog
用户主动选择文件时，必须用 OpenFileDialog（Avalonia 提供跨平台实现），不能硬写路径。
- 创建对话框并设置过滤器：var dialog = new OpenFileDialog { Filters = { new FileDialogFilter { Name = “文本文件”, Extensions = { “txt”, “log” } } };
- 异步调用：string[]? files = await dialog.ShowAsync(this);（
this是当前窗口实例） - 检查返回值是否为 NULL 或空数组，再读取：if (files?.Length > 0) { string text = File.ReadAllText(files[0]); }
- 注意：该对话框会自动适配 windows/macOS/linux 原生样式
读写二进制或大文件：用 FileStream 避免内存爆满
处理图片、音频、日志归档等大文件时，别一次性加载进内存。
- 用
using var fs = new FileStream(path, FileMode.Open, Fileaccess.Read, FileShare.Read, 4096, FileOptions.Asynchronous); - 配合
StreamReader（文本）或BinaryReader（二进制）分块读取 - 写入同理，用
FileMode.Create+FileStream或File.WriteAllBytes（小文件） - 涉及耗时操作，务必用
await Task.Run(() => { /* IO */ })脱离 UI 线程，防止界面卡死
注意事项与常见坑
Avalonia 应用常打包为单文件或自包含发布，路径逻辑容易出错。
- 不要依赖
Environment.CurrentDirectory—— 它可能指向临时目录或安装路径，不可靠 - 需要访问“我的文档”等系统路径？用
Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments) - macOS 和 Linux 上注意文件权限 —— 用户手动选的文件一般没问题，但程序自建路径需确保有写权限
- 调试时路径错误？加一句 console.WriteLine($”Trying to read: {path}”); 快速验证
基本上就这些。Avalonia 文件操作本身不复杂，核心是把 .NET 的 IO 习惯带进来，再补上路径安全和线程意识。