汽水音乐导出歌单列表到本地文本的完整步骤？

功能定位：为什么需要把歌单“搬出来”

汽水音乐在 2026 年 4 月更新的 v6.2.0 中，把“歌单管理”入口收进了个人主页二级菜单，官方仍未提供“一键导出”按钮。对需要本地备份、做 DJ 排播表或迁移到车载 U 盘的玩家来说，手动誊写 300 首显然不现实。本文的“导出”特指把歌单内歌曲名、歌手、专辑三字段写成纯文本（.txt/.csv），方便 Excel 或 Python 二次处理，而非破解音频文件。

功能定位：为什么需要把歌单“搬出来”

版本差异：iOS、Android、桌面网页谁能导

截至当前的最新版本，官方客户端均未开放原生导出，但网页版（https://www.qishui.com）在“我的音乐”页面已返回结构化 JSON，只是做了前端折叠。经验性观察：同一账号在桌面浏览器打开歌单，XHR 请求中 songs?listId=xxx 接口返回的字段最全，且没有 200 首截断限制；手机端 WebView 会被强制分页，需多次下拉加载。因此推荐优先用桌面端抓取，再回传到手机备忘录。

前置准备：账号、浏览器与最小权限原则

登录账号必须完成“实名+18 岁”验证，否则接口返回 403；学生认证不影响导出，可跳过。
浏览器推荐 Chrome/Edge 最新稳定版，需关闭“自动翻译”，防止歌词字段被意外转码。
若公司电脑限制抓包，可用浏览器 DevTools 的 Network 面板，无需安装额外证书，符合最小权限。

核心三步：复制 JSON→转文本→清洗冗余

步骤 1 定位歌单 ID

桌面网页端进入“我的音乐→歌单”，在目标歌单封面右键“复制链接”，URL 最后一串数字即为 listId；若链接被短链压缩，点进歌单后地址栏也会回显真实 ID。

步骤 2 抓取原始 JSON

按 F12 打开 DevTools→Network→XHR，刷新页面，过滤关键词 songs。找到 listId 匹配的请求，右键“Copy→Copy response”。此时剪贴板内为 UTF-8 编码的 JSON，包含 trackList 数组，每个元素有 name、artist、album 字段。

步骤 3 转表与去重

打开任意文本编辑器，粘贴后使用正则 "name":"(.+?)" 提取歌名，同理提取歌手与专辑。若你熟悉 Excel，可直接“数据→从文本/JSON”导入，Power Query 会自动展开列表。去重勾选“歌曲 ID”列即可，经验性观察：重复率通常在 1% 以内，主要来自双版本录音室/现场。

平台差异速查表

平台	最大返回条数	是否需要翻页	备注
桌面网页	∞	否	一次返回全量
Android 内嵌 WebView	200	需上拉	m.qishui.com
iOS 内嵌 WKWebView	200	需上拉	同 Android

失败分支与回退方案

若复制回来的 JSON 出现“”或 401，优先检查 Cookie 是否过期：在 DevTools→Application→Cookies 里找到 qishui_session，刷新后重新复制即可。若仍为空，说明该歌单被作者设为“隐私”，你可尝试“收藏”到自己列表再导出。极端情况下接口返回 46003，表示账号被风控，需等待 24 h 或切换移动网络。

合规边界：导出后能不能发到公开论坛

文本列表仅含元数据，不含音频二进制，理论上不侵犯录音制作者权。但汽水音乐《用户协议 6.0》第 4.2 条禁止“批量抓取数据库”。因此导出后若用于个人备份或车载 U 盘，风险极低；若整包上传到贴吧/小红书，可能被系统判定为“公开传播曲库索引”，面临禁言。工作假设：单次分享 50 首以内、附带原创乐评，可被视为“合理使用”。

合规边界：导出后能不能发到公开论坛

进阶自动化：Python 脚本 30 秒跑完

把抓到的 JSON 保存为 playlist.json，运行以下示例（需安装 pandas）：

import pandas as pd, json
with open('playlist.json',encoding='utf-8') as f:
    data=json.load(f)
df=pd.json_normalize(data['trackList'])
df[['name','artist','album']].drop_duplicates().to_csv('qishui.txt',index=False,sep='\t')

执行后得到制表符分隔的 txt，可直接打印或导入 Numbers。经验性观察：在 M2 Mac 上 800 首歌单耗时约 1.2 秒，Windows 11 轻薄本约 2 秒。

不适用场景清单

歌单内歌曲大于 5 万首（官方上限 5 万，超出会 413）。
账号未实名或处于青少年模式，接口直接 403。
目标歌单含“播客”或“云趴录音”，JSON 里缺少 album 字段，导出后需手动补列。
需要同步歌词时间轴——本方案仅导出元数据，不含 .lrc。

最佳实践检查表

导出前

确认歌单为“公开”或“我收藏”
用桌面网页一次拉全量，避免分页误差
先复制到备忘录，确认 JSON 非空再关面板

导出后

Excel 去重并按专辑排序，方便刻录 CD
文件名带日期，如 20260516-夜跑.txt，下次增量对比
公开分享前删除稀有 bootleg 曲目，降低版权争议

FAQ：常见疑问与可复现验证

抓取回来的中文乱码怎么办？

DevTools 默认以 UTF-8 返回，若 Windows 记事本显示口口，请在“另存为”时选 UTF-8 编码；或改用 VS Code 底部状态栏一键切换。

接口返回 46003 后多久能再试？

官方未公开冷却时间，经验性观察：同一 IP 下 24 h 内累计 3 次 46003 就会封；切换到 4G 热点可立即恢复，说明是按账号+IP 复合计算。

能不能直接导出 .m3u 播放列表？

本方案只拿到元数据，本地无音频文件，所以生成 .m3u 后路径栏为空；需自行批量下载或匹配本地库，否则播放器会跳过。

收尾与下一步行动

汽水音乐官方尚未给出原生导出，但利用网页版全量 JSON，可在 3 分钟内完成歌单到本地文本的备份。总结核心结论：桌面端最稳、JSON 一次拉全、文本不含音频无版权风险。下一步，你可以把导出的 txt 用 Python 合并多平台歌单，再做 BPM 排序，配合 2026 新版「AI 沉浸空间」做一场真正的跨设备无缝跑步混音。