图片存进相册却看不见，非要重启手机？保存到相册一步搞定

• 一个反复出现的反馈
• 真相：相册读的是媒体库，不是文件夹
• 实验一：亲手复现「拷了看不见」
• 实验二：保存到相册，立刻可见
• 案例：拍完照自动归档
• 老项目怎么办
• 排错表
• 小结
• demo 下载：

« 返回首页

一句话结论：把图片存进系统相册，用文件增强的保存到相册，不要用「拷贝文件」往相册目录拷——拷文件不入媒体库，相册看不见；保存到相册当场登记，立刻可见。

一个反复出现的反馈

几年来我们隔三差五收到同一种反馈：用「拷贝文件」把图片复制到手机的相册文件夹，打开相册——没有。文件管理器里明明在，相册就是装看不见。用户试过各种办法：

有位用户的描述特别传神：「感觉相册在装睡，只有重启手机这个闹钟才能叫醒它。」

说实话，我们一开始也跟着「放文件」的思路排了一遍：以为是路径不对，以为是权限，以为是相册缓存。全都治标不治本——因为思路从一开始就锚在同一件事上：把文件放对地方。直到把安卓的媒体机制从头到尾捋了一遍才发现：方向错了。问题从来不在「文件放哪儿」，而在「文件根本不该这么进相册」。

真相：相册读的是媒体库，不是文件夹

安卓手机上有个系统级的「媒体数据库」，正式名字叫 MediaStore。相册 App 打开时，不是去扫描文件夹，而是查这个数据库：「库里有哪些图片？」数据库里有什么，相册就显示什么。

这就好比图书馆：馆里进了一本新书，只要没在检索系统里登记，读者在检索机上就永远查不到——书明明就在馆里。拷贝文件，只是把书搬进了馆；重启手机，相当于图书馆做了一次全馆盘点，把每本书都补录进检索系统，相册这才「看见」你的图片。

理解了这个机制，前面所有怪现象都顺理成章：

• 重启相册 App 没用——相册只是检索系统的「显示屏」，重启显示屏不会让书被登记；
• 换目录没用——把书从 3 号书架挪到 5 号书架，照样没登记；
• 重启手机有用——只有这时系统才会做全盘媒体扫描，把漏登记的文件补进数据库。

鸿蒙和 iOS 也一样：系统都把「保存到相册」做成了专门通道，不鼓励 App 直接往相册文件夹写文件。

实验一：亲手复现「拷了看不见」

拖一个文件增强、一个按钮（按钮_拷贝）、一个标签（标签_状态），上传一张素材图 photo.png，用「拷贝文件」往 DCIM 目录拷：

when 按钮_拷贝.Click() {
  if 文件增强1.CopyFile("//photo.png", "DCIM/photo_copy.png") {
    标签_状态.Text = "拷贝成功，去相册找找看"
  } else {
    标签_状态.Text = "拷贝失败"
  }
}

跑起来看：提示「拷贝成功」后打开相册——没有这张图。再打开文件管理器进 DCIM 目录——文件确实在。

这就是那个老大难问题本身：文件进去了，媒体库不知道。

实验二：保存到相册，立刻可见

再加一个按钮 按钮_保存，换成保存到相册：

when 按钮_保存.Click() {
  if 文件增强1.SaveToGallery("//photo.png", "我的相册") {
    标签_状态.Text = "已保存，打开相册看看"
  } else {
    标签_状态.Text = "保存失败：文件不存在"
  }
}

跑起来看：点一下，立刻打开相册——照片已经躺在「我的相册」分组里了，不用重启任何东西。两个实验用的是同一张图、同一个组件，唯一区别是走没走媒体库登记。

说明：

• 第一个参数是源路径，// 开头表示 App 自带的素材文件，也可以是任意完整路径（比如相机拍完照给的路径）；
• 第二个参数是相册名，各大相册 App 会把它显示成一个相册分组，帮你把 App 存的图和随手拍的分开；留空 "" 存入系统默认位置；
• 图片、视频、音频都支持，分别进各自的标准位置（图片在 DCIM，和相机拍的照片同级）；
• 方法直接返回真假，失败（文件不存在、格式不支持）立刻能知道，不用等事件。

案例：拍完照自动归档

很多做出来的 App 是拍照类：巡检打卡、作业提交、成长记录。照相机拍完照，顺手就把照片存进相册——照相机事件的参数就是照片路径，直接喂给保存到相册，一步归档。拖一个照相机，配一个按钮调它的「拍照」方法：

global 张数 = 0
when 照相机1.AfterPicture(image) {
  张数 = 张数 + 1
  if 文件增强1.SaveToGallery(image, "巡检记录") {
    标签_状态.Text = join("第 ", 张数, " 张已存入相册")
  }
}

每拍一张，相册里立刻多一张，全部收在「巡检记录」相册里；页面上的计数告诉用户已经存了几张。

老项目怎么办

已有项目如果在用「拷贝文件」往相册目录复制图片，改造只要一步：把拷贝文件换成保存到相册——源路径参数原样保留，目标目录参数换成相册名，其余逻辑（成功提示、计数）都不用动。

拷贝文件方法本身不受影响：往普通文件夹（App 专用目录、下载目录等）复制文件，它照样是正确的选择。只有「进相册」这一件事必须走保存到相册。

排错表

小结

当所有「换地方」的尝试都失败时，该怀疑的是「放文件」这个思路本身。手机系统早已进入「数据库管理媒体」的时代：想让图片出现在相册里，走的应该是入库登记，而不是往文件夹里拷文件。这也是为什么安卓、鸿蒙、iOS 都把「保存到相册」做成了系统通道。

保存到相册已随文件增强上线，安卓、鸿蒙、iOS 同步支持。如果你的项目里也有「存了看不见」的困扰，换上这块积木试试——保存完立刻打开相册，图就在那儿。

demo 下载：

SaveToGalleryDemo.aia

上面两个实验的完整成品：一张随包橙色测试图，「① 拷贝」和「② 保存」两个按钮，照着本文一步步复现「拷了看不见 / 保存立刻见」的对比。导入即用。