汽水音乐歌单搬家记录：27 分钟、812 首歌、94.7% 成功率
换平台最麻烦的一步不是下载安装，是把用了五六年的歌单搬过去。我们拿一个 812 首的旧歌单做了完整迁移，最终成功匹配 769 首，失败 43 首，成功率 94.7%，总耗时 27 分钟。过程里有三个地方会卡住，都能提前规避。
背景
歌单迁移的难点不在传输速度，而在曲目识别。不同平台对同一首歌的命名不一致：现场版可能写成 Live、演唱会版或年份后缀，翻唱版会挂在原唱名下，remix 版本干脆只差一个括注。汽水音乐的导入逻辑靠歌名、歌手、专辑三个字段比对，字段越全，匹配越准。
第一步：导出旧歌单，别直接粘截图
主流平台都提供歌单导出，格式通常是 CSV 或文本列表，字段包含歌名、歌手、专辑、时长。如果找不到导出入口，用网页版打开歌单页复制整页文本也可以，但需要手工整理成每行一首的格式。
不要用截图或图片转文字。OCR 对专辑名里的连字符、日文假名、特殊符号识别率很低，812 首里我们试过 50 首截图识别，错字 11 处，其中 4 处错在歌手名，导致后续匹配全部失败。
整理时把字段顺序统一为“歌名 - 歌手 - 专辑”，用短横线分隔。缺少专辑字段的行保留占位符，导入时勾选“忽略空字段”，系统会退化为歌名加歌手两字段比对。
| 导入方式 | 样本量 | 字段完整度 | 后续匹配率 |
|---|---|---|---|
| 平台导出 CSV | 812 首 | 高（含专辑） | 94.7% |
| 网页复制文本 | 812 首 | 中（缺专辑） | 86.2% |
| 截图 OCR | 50 首 | 低（错字 11 处） | 58.0% |
第二步：分批导入，单批不超过 300 首
一次性导入 812 首时，进度条在 61% 停住，等待 8 分钟后提示“部分曲目处理超时”，已成功的部分保留，剩余未处理。把歌单按年代拆成三批（2000 年前、2000-2015、2015 年后）分别导入，三批全部一次通过。
分批还有一个好处：失败定位清楚。单批 300 首以内，失败列表一眼能看完；一次性导入失败时，列表混在一起，很难判断是版权缺失还是字段错误。
每批之间等 30 秒再开始下一批。导入任务在服务端排队，连续提交会挤占同一账号的配额，表现为第二批长时间停在 0%。
| 策略 | 批次 | 单批上限 | 完成率 | 总耗时 |
|---|---|---|---|---|
| 一次性导入 | 1 | 812 首 | 61% 后超时 | 18 分钟 |
| 按年代分三批 | 3 | 300 首 | 100% | 27 分钟 |
| 按语种分五批 | 5 | 180 首 | 100% | 31 分钟 |
第三步：43 首失败曲目逐类处理
43 首失败里，版权缺失 26 首，版本歧义 12 首，字段错误 5 首。版权缺失的曲目在汽水音乐确实没有上架，重试没有意义，正确做法是在结果页点“订阅上架提醒”，上架后会自动通知。
版本歧义最典型的是现场版。系统把《夜空中最亮的星》匹配到了录音室版，时长差 47 秒。这类需要手工在结果页选择正确版本，选中后原歌单位置不变，只替换曲目 ID。
字段错误多是繁体与简体混写造成的。把“陳奕迅”统一成“陈奕迅”后，5 首全部匹配成功。导入页提供简繁转换开关，建议在导入前打开。
| 失败原因 | 数量 | 是否可修复 | 处理方式 |
|---|---|---|---|
| 版权缺失 | 26 首 | 否 | 订阅上架提醒 |
| 版本歧义 | 12 首 | 是 | 手工选择正确版本 |
| 字段错误（简繁） | 5 首 | 是 | 开启简繁转换后重试 |
迁移工具的上限不是技术，是曲目元数据的质量。字段越规整，搬家越省事。—— 汽水音乐曲库运营同学在用户答疑中的说明
我们统计了 20 名用户的实际迁移数据：平均歌单规模 486 首，平均成功率 91.3%，其中使用 CSV 导出的 11 人成功率 94.1%，使用网页复制文本的 9 人成功率 87.9%。差距主要出现在专辑字段缺失导致的版本误匹配上。
写在最后
812 首搬完，769 首能听，43 首需要等上架或手工确认。整个过程最值得记住的一点是：先把元数据整理干净，再开始导入。歌单迁移不是一次性动作，后续新歌还是会加在旧平台，建议每月导出一次增量列表补进来，避免二次搬家。
读者评论（4）
按年代分批这个方法有用，我之前一次性导 600 首卡在 50% 不动，以为账号有问题。
简繁转换开关在哪？我导了三次都卡在陈奕迅那几首。
回复李工：导入页右上角设置里，勾选“简繁视为同一字段”。
版权缺失那 26 首建议直接列个清单，方便去别的平台补，不然容易漏。