163MusicLyrics 使用笔记：用文件夹扫描为本地音乐库批量生成 LRC 歌词

【免费下载链接】163MusicLyrics云音乐歌词获取处理工具【网易云、QQ音乐】项目地址: https://gitcode.com/GitHub_Trending/16/163MusicLyrics

163MusicLyrics 是一个开源的云音乐歌词获取处理工具，支持网易云音乐与 QQ 音乐两个平台，可单曲查询、整批链接批量导入或扫描本地文件夹，最终输出 LRC/SRT 文件。适合需要给本地音乐库补齐歌词、或把歌词转成字幕格式的开发者与普通用户。

首次上手：单曲检索跑通流程

获取与运行程序

官方 Release 页提供各平台的预编译安装包，Windows 用户解压即可运行，无需编译环境。如果想读源码或自行构建，项目主目录cross-platform/下是当前使用的 Avalonia 跨平台版本，核心服务接口位于 Core/Service/；archive-winform/子目录是早期 WinForms 实现的存档，参考代码时以跨平台目录为准。

git clone https://gitcode.com/GitHub_Trending/16/163MusicLyrics

单曲查询与保存

搜索区提供单曲、专辑、歌单三种查询类型，可输入 ID 或完整链接做精确查询；手里没有 ID 时切换到模糊搜索。命中后在歌词面板可核对原文与译文内容，再选择输出格式（LRC/SRT）与编码（UTF-8/GBK）保存。默认输出文件名为「歌曲名 - 歌手」，例如晴天 - 周杰伦.lrc，命名规则在设置中可改。

批量处理：让整目录音乐一次进列表

本地文件夹扫描

点击批量查询页的「本地扫描」按钮选择目录，工具会解析目录下音频文件的元数据并自动建立歌曲清单，不需要手动敲歌名。对命名规范的「歌手 - 歌名」文件效果最好；命名混乱的文件建议先整理，匹配成功率会明显更高。

批量粘贴链接与保存选中

除了扫描目录，也可以在批量查询输入框直接粘贴多个歌曲链接，每行一个，网易云与 QQ 音乐的链接可以混排。下方列表显示每首歌的来源、歌曲 ID、歌手、状态与备注，失败条目会在备注列直接给出原因，比如「歌词信息暂未收录或查询失败」，便于逐条排查。

批量查询按每批 300 条、批间间隔 500 毫秒的节奏向平台发起请求，这是刻意做的限速，避免被平台侧限流，因此大库处理需要等待数分钟属于正常现象。勾选目标行后点「保存选中」，在弹出的对话框选择保存目录，保存类型即 Lrc 文件（.lrc）。

同名文件与纯音乐处理

保存目录已有同名文件时，可在设置中选择「覆盖同名文件」或「自动追加编号」，编号后缀默认(1)，模板中的{n}代表序号，可自定义。另外有「保存时跳过纯音乐」开关，默认开启，批量保存时会自动过滤没有歌词的纯音乐曲目。

信息不全时：用模糊搜索挑选结果

只记得半个歌名、或者只知道歌手加一句歌词片段时，走模糊搜索路径：输入关键词后得到结果列表，列包括歌曲、歌手、专辑、时长、平台。同名版本（纯钢琴版、童声版、Live）会同时列出，需要人工确认选对条目再保存，这一步无法省略。

输出细节：文件名、时间戳与格式转换

文件名模板变量

输出文件名支持变量${id}、${index}、${name}、${singer}、${album}，还有一个填充函数：

${name} - ${singer} $fillLength(${index},0,3)

第二行表示把序号用 0 填充到 3 位，1 变成 001。配合已编号的音频文件命名，歌词文件能与音频一一对应、排序一致。

时间戳与 LRC/SRT 互转

LRC 默认时间戳格式为[mm:ss.SSS]，SRT 默认HH:mm:ss,SSS，两者都可在设置中按 HH/mm/ss/S/SS/SSS 元变量自定义。需要把歌词变成视频字幕时，用内置的格式转换页粘贴内容即可双向转换，LRC 转 SRT 与 SRT 转 LRC 都能直接导出。

译文与歌词组合

原文没有官方译文的歌曲，可接入百度翻译或彩云小译接口（在设置中填入自己的 AppId/密钥或 Token）自动翻译，输出时按「原文/译文」组合排列，多歌手之间的分隔符也可配置。

常见异常与配置位置

• 部分歌曲查不到歌词：多为纯音乐或平台未收录。换另一个平台重试，或确认「保存时跳过纯音乐」是否开着。
• 保存后播放乱码：编码不匹配，先试 UTF-8，仍乱码再换 GBK。
• 网络请求不稳定：设置支持系统代理、直连、HTTP 代理三种模式，HTTP 代理可填地址、端口与账号密码。
• 重复搜索响应慢：工具会把已获取的歌词与直链写入本地缓存，默认大小上限 128 MB，重复搜索直接走缓存。

所有设置持久化在MusicLyricAppSetting.json，Linux 下位于~/.config/MusicLyricApp/，可直接手工编辑后重启生效。

代码结构一览

跨平台版按 MVVM 组织：Models/ 放数据模型与设置项定义，SettingBean里能直接看到全部可配置项的默认值；歌词解析、SRT 转换、罗马音处理等纯逻辑放在 Core/Utils/。音乐平台一侧，网易云与 QQ 各自有NativeApi（对接接口）与Api（业务封装）两层，统一实现IMusicApi，翻译侧是同样的双实现结构。想扩展新平台，主要工作就是实现这个接口并接入注册处。

使用建议：Release 页保持定期查看，平台接口变动后的修复通常会以新版本发布；遇到查询失败等异常，到 Issue 页反馈时附上歌曲 ID 与平台信息，便于复现。

【免费下载链接】163MusicLyrics云音乐歌词获取处理工具【网易云、QQ音乐】项目地址: https://gitcode.com/GitHub_Trending/16/163MusicLyrics