在 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 习惯带进来，再补上路径安全和线程意识。
