使用immich-go处理Google相册导出数据的完整指南

前言

对于想要从Google相册迁移数据的用户来说，导出数据的处理一直是个棘手的问题。immich-go项目正是为解决这个问题而生，它能够帮助用户高效、准确地导入Google相册的导出数据。本文将深入解析Google相册导出数据的结构特点，以及immich-go如何处理这些复杂情况。

Google相册导出数据结构解析

基本目录结构

Google相册的导出数据采用了一种特殊的组织方式：

1. 按年份分类的文件夹：包含当年拍摄的所有照片
2. 相册文件夹：每个相册都有独立的文件夹
   • 包含一个JSON元数据文件（文件名可能因用户语言而异）
   • 相册标题可能为空
   • 通常包含相册中的所有图片
   • 这些图片通常也会出现在年份文件夹中

特殊文件夹

• 回收站：文件夹名称随用户语言变化（如Trash、Corbeille等）
• 失败视频：包含无法读取的视频文件
• 未命名相册：使用本地化名称加数字标识（如Untitled、Sin título等）

元数据文件分析

每张图片通常都有一个对应的JSON元数据文件，包含以下关键信息：

• 原始图片名称（可能与导出文件中的名称不同）
• 拍摄时间（时间戳格式）
• GPS坐标信息
• 是否被删除的标志
• 是否共享的标志

但需要注意的是，并非所有图片都有对应的JSON文件。

文件名匹配规则

Google相册导出数据中的文件名匹配遵循一些特殊规则：

1. 基本匹配规则：JSON文件名可以比图片文件名长1个字符

2. 同名文件处理：

   • 同年拍摄的同名文件会被编号区分
   • 例如：IMG_3479.JPG、IMG_3479(1).JPG等
   • 对应的JSON文件也会相应编号

3. 编辑后文件：

   • 编辑后的图片可能没有对应的JSON文件
   • 编辑标记会本地化（如法语使用"-modifié"）

多语言支持问题

Google相册会根据用户语言使用不同的术语：

语言	相册文件夹名	元数据文件名	编辑标记
英语	Google Photos	metadata.json	-edited
法语	Google Photos	métadonnées.json	-modifié
意大利语	Google Foto	metadati.json	-modificato
德语	Google Fotos	Metadaten.json	-bearbeitet

常见问题与解决方案

数据重复问题

从实际案例中可以看到，同一张图片可能会出现在：

1. 年份文件夹
2. "1年前"等时间分类文件夹
3. 特定相册文件夹

immich-go会智能处理这些重复文件，确保数据迁移的完整性。

特殊文件处理

1. 编辑后文件：需要识别本地化的编辑标记
2. 未命名相册：可能需要特殊处理以保持组织结构
3. 元数据缺失：部分图片可能缺少JSON元数据文件

最佳实践建议

1. 预处理检查：在导入前检查导出数据的完整性
2. 语言设置：确认导出数据的语言版本
3. 分批处理：大型导出数据可分批次导入
4. 验证结果：导入后检查关键元数据是否完整

遇到问题怎么办

如果使用immich-go处理导出数据时遇到问题，建议：

1. 详细记录问题现象
2. 提供相关文件样本
3. 描述预期的正确结果

对于复杂情况，可能需要结合自动导入和手动处理的方式。

结语

Google相册导出数据的复杂性不容小觑，但通过immich-go这样的专业工具，用户可以大大简化迁移过程。理解导出数据的结构特点有助于更好地使用工具，顺利完成数据迁移工作。