MAUI文本编辑器Windows端保存文件遇System.UnauthorizedAccessException异常

出现System.UnauthorizedAccessException的核心原因是MAUI Windows应用基于WinUI 3，遵循UWP权限模型，直接通过FileStream写入未授权路径会被系统拦截，以下是具体解决方法：

一、改用系统文件选择器获取可写路径 #

不要硬编码文件路径，通过系统保存文件选择器让用户指定位置，系统会自动授予该文件的写入权限，修改后的代码如下：

private async Task HandleSaveClick()
{
    if (string.IsNullOrEmpty(fileContent))
        return;

    var savePicker = new Windows.Storage.Pickers.FileSavePicker();
    savePicker.SuggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.DocumentsLibrary;
    savePicker.FileTypeChoices.Add("文本文件", new List<string> { ".txt" });
    savePicker.SuggestedFileName = "新建文档";

    var targetFile = await savePicker.PickSaveFileAsync();
    if (targetFile != null)
    {
        // 使用StorageStream写入，绕过权限限制
        using var stream = await targetFile.OpenStreamForWriteAsync();
        var fileBytes = Encoding.UTF8.GetBytes(fileContent);
        await stream.WriteAsync(fileBytes, 0, fileBytes.Length);
    }
}

二、声明必要的文件系统权限（针对固定目录访问） #

如果需要直接访问文档库等固定目录，需在Windows平台的清单文件中配置权限：

1. 打开项目中Platforms/Windows/Package.appxmanifest文件
2. 切换到「功能」标签，勾选「文档库访问」
3. 同时在清单的XML代码中添加文件类型关联（以.txt为例），否则权限声明无效：

<Extensions>
  <uap:Extension Category="windows.fileTypeAssociation">
    <uap:FileTypeAssociation Name="textfiles">
      <uap:SupportedFileTypes>
        <uap:FileType>.txt</uap:FileType>
      </uap:SupportedFileTypes>
    </uap:FileTypeAssociation>
  </uap:Extension>
</Extensions>

三、禁止直接写入沙箱外未授权路径 #

MAUI Windows应用默认仅能访问自身沙箱目录（如ApplicationData.Current.LocalFolder），如果未通过文件选择器或权限声明，直接写入C盘根目录、Program Files等系统目录必然触发权限异常。

四、排查文件占用问题 #

如果以上方法仍报错，检查目标文件是否被其他进程（如记事本、其他编辑器）锁定，关闭相关程序后再尝试保存。

内容的提问来源于stack exchange，提问作者Ilya Vasunin