如何在Flutter Dart中通过图片路径永久删除设备图库本地图片

直接调用dart.io.File.delete()仅删除了文件系统中的文件，但系统媒体库（图库）依赖自身数据库缓存，不会自动同步文件删除状态，因此图库仍会显示已删除图片的缓存条目。此外，你的代码存在异步操作处理不当的问题（在setState中直接调用异步的delete()）。

推荐使用photo_manager包，它可以直接操作系统媒体库的资产，删除时会同步更新媒体库数据库，确保图库实时移除目标图片。

步骤1：添加依赖 #

在pubspec.yaml中添加：

dependencies:
  photo_manager: ^2.7.2
  image_picker: ^1.0.4
  image_gallery_saver: ^1.7.1 # 若仍需保存图片到图库则保留

步骤2：配置权限 #

Android（AndroidManifest.xml） #

<!-- Android 13及以上 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
<uses-permission android:name="android.permission.DELETE_PHOTOS"/>

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

iOS（Info.plist） #

<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册选择图片</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>需要保存图片到相册</string>
<key>NSPhotoLibraryDeleteUsageDescription</key>
<string>需要删除相册中的图片</string>

步骤3：修改代码 #

场景1：删除选中的原图 #

import 'package:photo_manager/photo_manager.dart';
import 'package:image_picker/image_picker.dart';

void takePhoto() async {
  final ImagePicker _picker = ImagePicker();

  try {
    final recordedImage = await _picker.pickImage(source: ImageSource.gallery);
    if (recordedImage != null) {
      // 申请媒体库权限
      final permission = await PhotoManager.requestPermissionExtend();
      if (!permission.isAuth) {
        print("权限不足，无法删除图片");
        return;
      }

      // 根据图片路径获取对应的媒体资产
      final assetList = await PhotoManager.getAssetListWithPath(recordedImage.path);
      if (assetList.isNotEmpty) {
        final targetAsset = assetList.first;
        // 删除资产（同步更新媒体库）
        await targetAsset.delete();
        setState(() {
          fileImage = null;
        });
        print("图片已成功删除，图库同步更新");
      }
    }
  } catch (e) {
    print("删除失败：${e.toString()}");
  }
}

场景2：删除保存到图库的副本 #

若需删除通过ImageGallerySaver保存的副本，可修改为：

import 'package:image_gallery_saver/image_gallery_saver.dart';
import 'package:photo_manager/photo_manager.dart';
import 'package:image_picker/image_picker.dart';

void takePhoto() async {
  final ImagePicker _picker = ImagePicker();

  try {
    final recordedImage = await _picker.pickImage(source: ImageSource.gallery);
    if (recordedImage != null) {
      // 保存图片到图库
      final result = await ImageGallerySaver.saveFile(recordedImage.path, isReturnPathOfIOS: true);
      final savePath = result['filePath'].toString().replaceAll(RegExp('file://'), '');
      print("保存路径：${savePath}");

      // 申请权限
      final permission = await PhotoManager.requestPermissionExtend();
      if (!permission.isAuth) {
        print("权限不足");
        return;
      }

      // 根据保存路径获取资产并删除
      final assetList = await PhotoManager.getAssetListWithPath(savePath);
      if (assetList.isNotEmpty) {
        await assetList.first.delete();
        setState(() {
          fileImage = null;
        });
        print("副本图片已删除，图库同步更新");
      }
    }
  } catch (e) {
    print("操作失败：${e.toString()}");
  }
}

关键说明 #

1. 必须通过媒体库API删除资产，而非仅删除文件系统中的文件，否则图库不会同步更新。
2. 异步操作需使用await等待完成，避免在setState中直接调用异步方法。
3. 确保权限配置正确，不同系统版本的权限要求有差异。

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