从谷歌相册搬家到 Immich：Takeout 导出与 immich-go 导入全流程

迁移季的重头戏：把在谷歌相册住惯了的几万张照片，安全搬进 Immich。官方文档明确推荐了一条路：Takeout 导出 + immich-go 导入——不要手动解压逐个拖拽，也不要直接用 CLI 硬传。

为什么是 immich-go 而不是官方 CLI

谷歌相册的官方导出服务叫 Google Takeout，它交给你的是一堆分卷压缩包，内部还有配套的 JSON 元数据文件（记录拍摄时间、相册归属、地理信息——很多正是压缩包里照片的 EXIF 缺失部分）。

官方 CLI 的 upload 面向「普通目录」，不解析这套结构。社区维护的 immich-go 专门吃这个格式：自动解开分卷、读取 JSON 元数据补全日期和归属、按原相册结构在 Immich 里重建相册。官方文档把它列为 Takeout 导入的推荐工具，项目在 GitHub 可查（以工具当前版本的说明为准）。

完整流程四步

第一步：Takeout 导出。Google 账号的 Takeout 页面 → 只选「Google 相册」→ 选导出格式与分卷大小 → 等待生成（大库要几小时到几天）→ 把全部分卷下载到电脑。

第二步：核对导出物。确认分卷数量与 Takeout 标注一致、每个分卷完整可解压——导出中途失败不是新鲜事，先验证再开跑。

第三步：immich-go 导入。按工具文档连接你的 Immich 实例（API 密钥的获取见 API 与命令行），指向解压后的 Takeout 目录执行导入。跑之前先读它的参数说明——「重建相册」「处理 JSON 元数据」这些开关都在。

第四步：Immich 侧收尾。导入完成后到 任务队列 看着缩略图、智能搜索、人脸识别把这几万张照片消化完；然后按 相册同步 与 共享相册 把家庭分享体系重新挂上。

迁移前后的四个务实提醒

• 先小后大：先拿一个 Takeout 分卷试跑全流程（导入 → 检查日期/相册/人脸），确认无误再放量；
• 谷歌相册的「编辑版」问题：Takeout 导出的可能包含编辑过的版本与原版并存，工具一般有对应处理策略，导入设置里看一眼；
• 迁移期间别删源：谷歌相册里的一切保持原状，直到你在 Immich 侧完成 备份清单 的全部确认——迁移的完成标志是「两边都有完整副本」，不是「一边导完了」；
• 账号冻结风险：大批量 API 操作在谷歌侧有触发风控的先例，Takeout 导出走网页分批下载更稳妥。

从其他云相册迁移

思路同构：先「导出成带元数据的目录」（各家都有自己的 Takeout 等价物或第三方导出工具），再走 CLI/immich-go 类工具导入。核心纪律只有一条——元数据（日期、地点、相册）比文件本身更容易在迁移中丢失，每一步都围绕它验证。

至此，从部署到搬家、从备份到分享的完整闭环走完了。散装问题汇总在最后一页：常见问题排查。