一首首复制歌词太痛苦？用 ZonyLrcToolsX 一次性补齐整个音乐库的歌词

【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX

你有没有过这样的经历：从网上下载了一整张专辑的歌曲，播放器里却只有干巴巴的旋律，想跟着唱只能切到网页版歌词；或者辛辛苦苦整理了几百首 flac、mp3，最后发现它们全都"哑巴"了。手动去音乐网站一首首复制歌词再存成 .lrc 文件？十分钟搞不定三首歌。

ZonyLrcToolsX 就是为解决这个问题而生的跨平台歌词下载工具：它扫描你指定的文件夹、歌单甚至 CSV 清单，自动从网易云音乐、QQ 音乐、酷狗、酷我四个平台抓取歌词并写成同名 .lrc 文件，全程不需要你碰一次复制粘贴。这篇文章会带你从零跑通第一个下载任务，并顺便解锁它的几个隐藏玩法。

五分钟跑通第一次批量下载

安装上不必纠结，ZonyLrcToolsX 同时提供桌面端（Avalonia 图形界面）和命令行端。如果你用的是 Arch Linux 及其衍生发行版，一条命令就能装好：

yay -S zonylrctoolsx-bin

其他系统的用户直接去 Release 页下载对应平台的压缩包即可。装好后打开终端，进入存放音乐的目录，执行：

ZonyLrcTools.Cli download -sc local -d "D:\Music" -l

-sc local表示扫描本地文件夹，-d指定音乐目录，-l表示下载歌词。命令运行后，工具会遍历该目录下所有 mp3、flac、wav、m4a 等常见格式（具体后缀可在config.yaml的supportFileExtensions里增删），然后自动下载并生成同名.lrc文件。

💡 小提示：默认的歌词文件名是{Artist} - {Name}.lrc，想换成"歌曲名.lrc"这种格式，用-p "{Name}.lrc"指定即可。

歌词源"接力赛"：一个平台找不到，自动换下一个

很多同类工具只有一个歌词源，冷门歌曲一搜就扑空。ZonyLrcToolsX 则内置了四个下载器，下载时会按优先级依次尝试——网易云找不到就试 QQ 音乐，再不行就换酷狗、酷我，直到命中为止。

四个源的优先级和开关都在src/ZonyLrcTools.Cli/config.yaml的provider.lyric.plugin段落里，把某个源的priority改成-1就能禁用它。如果你偏爱某平台的翻译歌词，还可以在这里打开isEnableTranslation（翻译）和isOneLine（双语合并成一行），让歌词文件既完整又清爽。

⚠️ 小坑预警：如果你下载的是纯音乐，工具会把它标记为"跳过"，不会留下空壳歌词文件，最后还会生成一份"歌词下载失败列表"，方便你复查哪些歌没配上。

进阶场景一：网易云歌单一键补齐

本地文件夹之外，另一个高频需求是"把我收藏的歌单全部配上歌词"。ZonyLrcToolsX 支持直接读取网易云歌单：

ZonyLrcTools.Cli download -sc netease -s "歌单ID" -o "输出目录" -l

首次使用会弹出一个 ASCII 二维码，用网易云 App 扫码登录后，工具就能拿到完整歌单并逐首下载。多个歌单用分号分隔即可，比如-s "7224428149;83302922"。想看这个过程怎么实现的，可以去读src/ZonyLrcTools.Common/MusicScanner/NetEaseMusicSongListMusicScanner.cs，里面包含二维码登录、参数加密等完整逻辑。

进阶场景二：CSV 清单精准投喂

如果你手上有一份现成的歌曲清单（比如从数据库导出的收藏列表），没必要先把歌下载下来——直接写一个两列的 CSV 文件（Song,Artist，首行是表头），然后：

ZonyLrcTools.Cli download -sc csv -f "playlist.csv" -o "输出目录" -l

工具会自动识别 CSV 的编码（UTF-8、GBK 都能处理），按清单逐行下载歌词，非常适合批量处理"歌在云端、词在本地"的场景。CSV 扫描器的实现见src/ZonyLrcTools.Common/MusicScanner/CsvFileMusicScanner.cs。

彩蛋：顺手把你的 ncm 加密文件"救"出来

ZonyLrcToolsX 还内置了一个不常被提起的实用功能——解密网易云下载的加密文件。很多.ncm格式的歌曲在其他播放器里根本打不开，用util子命令可以批量转换：

ZonyLrcTools.Cli util -s "存放ncm文件的文件夹"

工具会自动扫描文件夹内所有加密文件并转换为可用的音频格式，转换结果单独保存，不会覆盖原文件。相关代码在src/ZonyLrcTools.Cli/Commands/SubCommand/UtilityCommand.cs。

写在最后

从本地文件夹到云歌单，从 CSV 清单到 ncm 解密，ZonyLrcToolsX 把"给音乐库补歌词"这件事压缩成了一两条命令。下次面对几百首没歌词的歌，别再一首首手动复制了——让工具替你跑完这趟重复劳动，你只需要坐下来，听着歌，跟着屏幕上的歌词轻轻哼起来。

想深入了解参数细节，可以翻阅项目里的docs/文档；想折腾更多玩法，源码仓库就是最好的说明书，动手 clone 一份，改改config.yaml，你会发现它比想象中更灵活。

【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX