React Native如何将图片保存到自定义存储位置？

嘿，我之前也踩过这个坑！React Native自带的CameraRoll API其实不支持直接指定多层级的自定义文件路径——它的album参数只能帮你指定一级相册名称，没法创建像testfolder/1这样的嵌套目录结构，而且在Android和iOS上的存储逻辑还有不小的差异，咱们分开说：

一、Android平台：用文件系统操作实现自定义路径 #

Android的系统相册是基于MediaStore索引的，CameraRoll默认会把图片放到DCIM目录或者对应相册的系统默认路径，没法直接控制到具体的子文件夹。要实现自定义路径，推荐用react-native-fs这个第三方库直接操作文件系统，步骤如下：

1. 先安装依赖：

npm install react-native-fs --save
# 或者用yarn
yarn add react-native-fs

2. 编写保存逻辑（支持多级目录创建）：

import RNFS from 'react-native-fs';
import { Platform } from 'react-native';

const saveImageToCustomFolder = async (imageUri) => {
  // 目标路径：外部存储根目录下的testfolder/1
  const targetDirectory = `${RNFS.ExternalStorageDirectoryPath}/testfolder/1`;
  // 从原URI中提取文件名
  const fileName = imageUri.split('/').pop();
  const targetFilePath = `${targetDirectory}/${fileName}`;

  try {
    // 检查目标目录是否存在，不存在则递归创建多级目录
    const dirExists = await RNFS.exists(targetDirectory);
    if (!dirExists) {
      await RNFS.mkdir(targetDirectory, { recursive: true });
    }

    // 复制图片到目标路径
    await RNFS.copyFile(imageUri, targetFilePath);

    // 关键步骤：通知系统媒体库扫描新文件，这样才能在相册里看到它
    if (Platform.OS === 'android') {
      await RNFS.scanFile(targetFilePath);
    }

    console.log('图片已保存到:', targetFilePath);
  } catch (error) {
    console.error('保存失败:', error);
  }
};

// 调用方法
saveImageToCustomFolder(data.uri);

注意：Android 10及以上需要在AndroidManifest.xml中添加android:requestLegacyExternalStorage="true"（适配旧版存储权限），如果是最新RN版本，react-native-fs已经支持Scoped Storage的适配。

二、iOS平台：受限于相册系统的特殊处理 #

iOS的相册是基于「相册（Album）」的概念，没有像Android那样的文件路径层级——你没法在一个相册里再创建子文件夹。如果想要类似的分类效果，有两种方案：

• 方案1：创建一级相册（比如命名为test-1），用CameraRoll的album参数保存进去：

CameraRoll.saveToCameraRoll(
  { uri: data.uri, album: 'test-1' },
  'photo'
)
.then((newUri) => console.log('保存到相册test-1:', newUri))
.catch(err => console.error('错误:', err));

• 方案2：如果一定要存到文件系统的自定义路径，只能放到应用的私有目录（比如Documents），但这样的图片不会显示在系统相册里。如果要让它出现在相册，还是得用CameraRoll配合相册名称，或者通过原生PhotoKit进行更复杂的操作。

为什么你之前的代码没生效？ #

你尝试的{ uri: data.uri, album: 'test' }写法，本质上是告诉CameraRoll把图片放到名为test的相册里，而不是文件系统的test文件夹。在Android上，这个相册可能对应DCIM下的一个子文件夹，但没法指定更深的层级；在iOS上，就是独立的系统相册，和文件路径完全无关。

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