Flutter如何将相机拍摄的图片保存到内部存储指定目录

核心逻辑很简单：takePicture返回的缓存路径下的图片本身就是本地实体文件，不需要做额外的编解码操作，直接通过Dart自带的文件IO能力做复制/剪切即可完成转存。

前置依赖 #

如果需要自动适配不同系统版本的合法存储路径、避免硬编码路径导致的权限/适配问题，建议在pubspec.yaml中引入两个工具包（如果已有固定目标路径可跳过此步）：

dependencies:
  path: ^1.8.3 # 用于跨平台路径拼接、文件名解析
  path_provider: ^2.1.1 # 用于获取系统标准目录路径

实现步骤 #

• 1. 导入所需的工具包

import 'dart:io';
import 'package:path/path.dart' as p;
import 'package:path_provider/path_provider.dart';

• 2. 读取缓存目录下的源图片文件
     拍摄完成后直接通过XFile返回的路径初始化源文件实例即可：

// 这里的capturedXFile就是你调用takePicture方法拿到的返回值
final XFile capturedXFile = await cameraController.takePicture();
final File sourceImg = File(capturedXFile.path);

• 3. 创建目标存储目录
     根据自己的业务需求选择存储位置，提前创建不存在的目录：
  • 若存储到应用专属内部目录：不需要申请任何存储权限，目录仅当前应用可访问，应用卸载时文件会同步删除

  // 可按需替换为getApplicationSupportDirectory、getApplicationCacheDirectory等其他专属目录
  final Directory appRootDir = await getApplicationDocumentsDirectory();
  // 自定义子目录，比如专门存拍摄原图的文件夹
  final Directory targetDir = Directory(p.join(appRootDir.path, 'camera_originals'));
  // 目录不存在时递归创建所有父级目录
  if (!await targetDir.exists()) {
    await targetDir.create(recursive: true);
  }
  

  • 若存储到公共内部存储目录：文件可被其他应用访问，应用卸载后不会删除，需要根据系统版本申请对应的媒体读写权限，不要硬编码/sdcard/这类废弃路径，需通过系统API获取分区存储下的合法公共目录。
• 4. 执行文件转存
     两种转存方式按需选择即可：
  • 复制模式：保留缓存目录下的原文件，转存独立副本，缓存文件后续会被系统自动清理

  // 直接复用原文件的文件名，避免重名冲突，也可根据业务规则自定义文件名
  final String targetPath = p.join(targetDir.path, p.basename(sourceImg.path));
  final File savedImg = await sourceImg.copy(targetPath);
  // savedImg就是转存完成后的文件，可直接读取savedImg.path做后续上传、预览等业务操作
  

  • 移动模式：直接将缓存文件剪切到目标目录，不在缓存中留副本，更节省存储空间

  final String targetPath = p.join(targetDir.path, p.basename(sourceImg.path));
  final File savedImg = await sourceImg.rename(targetPath);
  

注意事项 #

• 不要持久化存储缓存目录路径做业务使用，应用缓存会被系统、手机清理工具不定期删除，只有转存后的目标路径可以长期使用。
• 跨平台拼接路径不要手动拼接/分隔符，使用path包的join方法自动适配Android、iOS的路径格式规则。
• 如果转存到公共目录后需要让系统相册立即识别到新图片，可调用媒体扫描API刷新系统媒体库，不需要该能力可跳过。

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