.NET MAUI跨平台从文件夹加载图片的路径问题

1. 先理清Android的文件访问逻辑 #

Android对文件系统权限管控严格，硬写/data目录的绝对路径会因为应用安装路径差异、系统权限限制导致访问失败。必须用MAUI提供的标准API获取应用可访问的合法目录，不能自己瞎拼路径。

2. 确定图片的存放位置 #

根据图片来源分两种场景处理：

场景一：应用打包时自带的图片 #

• 把所有图片放到项目的Resources/Images文件夹下
• 选中所有图片，在属性面板设置生成操作为MauiImage，复制到输出目录为如果较新则复制
• 这种方式打包后图片会嵌入应用资源，跨平台都能稳定访问

场景二：运行时生成/用户导入的图片 #

用MAUI的FileSystem类获取安全目录：

• 应用私有目录（仅当前应用可访问，无需额外权限）：FileSystem.AppDataDirectory
• 公共图片目录（系统相册等，需要申请权限）：await FileSystem.GetFolderAsync(SpecialFolder.Pictures)

3. 修改你的加载代码 #

针对打包自带图片的修改 #

用资源加载更可靠，避免路径问题：

// 获取当前页面所在程序集，用于读取资源
var assembly = typeof(YourPageName).GetTypeInfo().Assembly;
// 筛选出所有png格式的资源文件
var imageResourceNames = assembly.GetManifestResourceNames()
    .Where(name => name.EndsWith(".png", StringComparison.OrdinalIgnoreCase));

var stackLayout = new StackLayout();

foreach (var resourceName in imageResourceNames)
{
    var photoImage = new Image
    {
        Source = ImageSource.FromResource(resourceName, assembly),
        Aspect = Aspect.AspectFill
    };

    var photoFrame = new Frame
    {
        CornerRadius = 10,
        Padding = 5,
        BackgroundColor = Colors.LightGray,
        Content = photoImage,
        Margin = new Thickness(10)
    };

    stackLayout.Children.Add(photoFrame);
}

针对应用私有目录图片的修改 #

如果图片存放在应用私有目录，直接用FileSystem获取路径：

// 获取应用私有目录的绝对路径
string folderPath = FileSystem.AppDataDirectory;
// 读取目录下所有png文件
string[] imagePaths = Directory.GetFiles(folderPath, "*.png");

var stackLayout = new StackLayout();

foreach (string imagePath in imagePaths)
{
    var photoImage = new Image
    {
        Source = ImageSource.FromFile(imagePath),
        Aspect = Aspect.AspectFill
    };

    var photoFrame = new Frame
    {
        CornerRadius = 10,
        Padding = 5,
        BackgroundColor = Colors.LightGray,
        Content = photoImage,
        Margin = new Thickness(10)
    };

    stackLayout.Children.Add(photoFrame);
}

4. 大量图片加载的性能优化 #

用StackLayout加载大量图片会导致页面卡顿，建议改用CollectionView，它支持虚拟滚动，只渲染当前可见区域的图片：

// 获取图片路径集合
string folderPath = FileSystem.AppDataDirectory;
var imagePaths = Directory.GetFiles(folderPath, "*.png").ToList();

// 创建CollectionView，设置2列网格布局
var collectionView = new CollectionView
{
    ItemsLayout = new GridItemsLayout(2, ItemsLayoutOrientation.Vertical),
    ItemTemplate = new DataTemplate(() =>
    {
        var photoImage = new Image
        {
            Aspect = Aspect.AspectFill,
            HeightRequest = 150,
            WidthRequest = 150
        };
        // 绑定图片路径，需要配合转换器
        photoImage.SetBinding(Image.SourceProperty, new Binding(".", converter: new StringToImageSourceConverter()));

        var photoFrame = new Frame
        {
            CornerRadius = 10,
            Padding = 5,
            BackgroundColor = Colors.LightGray,
            Margin = new Thickness(10),
            Content = photoImage
        };

        return photoFrame;
    })
};

// 设置数据源
collectionView.ItemsSource = imagePaths;
// 把CollectionView设为页面内容
Content = collectionView;

需要添加一个字符串转ImageSource的转换器：

public class StringToImageSourceConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (value is string path && !string.IsNullOrEmpty(path))
        {
            return ImageSource.FromFile(path);
        }
        return null;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        throw new NotImplementedException();
    }
}

5. 公共目录访问的权限说明 #

如果要访问系统公共图片目录，需要在Platforms/Android/AndroidManifest.xml中添加权限：

<!-- Android 12及以下 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- Android 13+ -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

并且在运行时主动请求权限：

var permissionStatus = await Permissions.RequestAsync<Permissions.StorageRead>();
if (permissionStatus != PermissionStatus.Granted)
{
    // 提示用户授权，否则无法访问公共目录
}

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