ZonyLrcToolsX：免费开源的跨平台歌词批量下载神器，一条命令补齐整个音乐库

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

你有多久没在本地播放器里看到完整歌词了？ZonyLrcToolsX 是一款免费开源的跨平台歌词批量下载工具，聚合网易云音乐、QQ 音乐、酷狗、酷我四大平台，用一条命令就能为整个音乐库补全 LRC 歌词。无论是几百首的私人曲库，还是刚导出的网易云歌单，它都能在几分钟内替你搞定那些重复到麻木的手工活。

深夜十一点，我在和五百首歌较劲

周五晚上，我翻出那块用了三年的 U 盘，打算给周末的长途自驾备点音乐。拷贝完五百多首歌，打开播放器一看——歌词区域空空如也。

接下来的两个小时，我过上了"复制-粘贴-另存为"的流水线生活：打开浏览器搜歌名，找到歌词网页，选中全文，新建 txt，粘贴，改成 .lrc 后缀，再手动对齐时间轴。弄到第四十首的时候，我已经在认真考虑"没有歌词也不是不能听"。

我相信这不是我一个人的深夜崩溃。只要你的本地音乐超过五十首，手动补歌词这件事就从"小麻烦"升级成了"不可能的工程"。

复盘：歌词这件事，到底难在哪三处

动手折腾之前，先冷静拆一下问题。你会发现，这活儿难，难在三个相互叠加的地方。

第一处：平台之间，各自为政。网易云的歌，QQ 音乐未必有；酷狗的歌词，酷我不让下。想凑齐一个曲库的歌词，你得在不同网站之间反复横跳，有的平台甚至要求登录才能拿高质量资源，步骤又多一道。

第二处：歌词格式，暗坑不断。就算你搜到了歌词，也可能遇到没有时间轴的纯文本、编码不对显示乱码、翻译和原文混在一起没法看。把这种半成品塞进播放器，体验比没有歌词更糟。

第三处：曲库一大，手动就崩。单首歌两分钟，五百首就是一千分钟。时间成本一上来，这件事就注定无法靠"勤快"解决。

看出共性了吗？真正缺的不是歌词，而是一个能"自己找、自己下、自己整理"的自动化管道。

主角登场：ZonyLrcToolsX 的四个关键词

ZonyLrcToolsX 就是为上面三个坑量身定做的。它的工作方式很朴素：扫描你的音乐文件 → 根据文件名或标签信息识别歌曲 → 依次向多个平台查询歌词 → 找到后统一转成标准 LRC 格式存回原目录。全程你只需要敲一条命令。

用四个关键词就能说清它：

• 免费开源：源码完全开放，可自由审查、二次修改，不存在"用着用着开始收费"的隐患；
• 跨平台：Windows、Linux、macOS 通吃，换系统不换习惯；
• 四平台聚合：网易云、QQ、酷狗、酷我一个不漏，一个平台找不到就自动换下一个；
• 统一输出：不管歌词来自哪家，最终都变成标准 LRC 文件，任何播放器都能直接识别。

上图是它最让我惊喜的细节：当你需要网易云的高质量歌词资源时，命令行会直接生成二维码，掏出手机扫一下就完成登录，连账号密码都不用敲。

三步上手：今晚就拿到第一批歌词

工具再好，得先跑起来。整个过程真的只要三步。

第一步：把工具带回家。Arch Linux 用户可以直接从 AUR 安装：

yay -S zonylrctoolsx-bin

其他系统用户克隆仓库自行构建：

git clone https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX

第二步：一条命令开始扫描。指定音乐文件夹，让它下载歌词：

ZonyLrcTools.Cli download -d "你的音乐文件夹路径" -l

拆开看：download是下载命令；-d指向要扫描的音乐目录；-l表示这次任务要下载歌词。如果你还想要专辑封面，加上-a参数即可。

第三步：验收成果。命令跑完后回到文件夹，你会发现每首歌旁边都多了一个同名 .lrc 文件，文件名会自动按"歌手 - 歌名.lrc"生成。重新打开播放器，歌词已经整整齐齐地躺在那里了。

进阶：把批量下载调成私人流水线

基础玩法只能算开胃菜，下面这几个参数才是让它真正"好用"的关键。

多线程加速，几百首歌也不在话下。默认单线程跑，但你可以指定并行数量：

ZonyLrcTools.Cli download -d "音乐文件夹" -l -n 8

-n 8代表 8 个线程同时下载。五百首歌的曲库，喝杯水的功夫就全齐了。

三种扫描方式，覆盖几乎所有使用场景。默认的本地扫描适合"文件夹里有歌"的情况；如果你有一份整理好的歌单，可以用 CSV 文件批量导入：

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

最妙的是，它还支持直接把网易云歌单拉下来。只要知道歌单 ID：

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

在线歌单瞬间变成本地 LRC 歌词库，适合批量归档收藏夹里的老歌。

顺手的小惊喜：解密 .ncm 加密文件。网易云下载的 .ncm 格式是加密的，其他播放器根本读不了。ZonyLrcToolsX 自带的util命令能一键解密，把 .ncm 转成普通音频文件，连加密这关都替你打通了：

ZonyLrcTools.Cli util -s "要解密的文件或文件夹路径"

高手菜单：config.yaml 里的五个高频调优项

如果说命令参数管的是"一次性任务"，那么配置文件管的就是"长期偏好"。它位于src/ZonyLrcTools.Cli/config.yaml，打开之后有五个地方值得你动手。

1. 平台优先级。在lyric.plugin里，每个平台都有一个priority值，数字越小越优先。默认网易云排第一；如果你更信任 QQ 音乐的歌词质量，把它俩的数值换一下就行。想让某个平台彻底不参与，把它的 priority 改成 -1。

2. 搜索深度。网易云和酷狗支持depth参数，默认 10。搜不到歌时把它调大，能捞回更多候选结果，代价是搜索时间变长。建议日常保持默认，遇到冷门歌再临时调。

3. 翻译歌词开关。isEnableTranslation: true时，外文歌会附带中文翻译；isOnlyOutputTranslation设为 true 则只保留翻译。学外语、练听力的场景下这组参数非常值钱。

4. 双语合并与换行。isOneLine控制原文和译文是否合并为一行，lineBreak控制换行符类型。不同播放器对这两种格式的兼容性不一样，出现显示异常时优先检查这里。

5. 文件编码。fileEncoding默认 utf-8。如果你的播放器是老旧设备（比如部分车载系统），改成 gbk 之类的中文编码能有效避免乱码。

全部改完保存，下次运行立即生效，不需要重新编译。

开源底牌：为什么可以放心长期使用

选工具，最怕的就是"跑路"。而 ZonyLrcToolsX 的开源属性，恰恰是这个项目最让人安心的部分。

代码完全公开，插件式的模块结构一目了然：歌词下载逻辑集中在src/ZonyLrcTools.Common/Lyrics/Providers/，标签识别在src/ZonyLrcTools.Common/TagInfo/，你甚至可以直接读代码确认它"到底往你电脑里写了什么"。依赖 .NET 生态和 Avalonia 桌面框架，跨平台能力是底层架构决定的，不是后天打补丁，长期维护有保障。更详细的说明可以翻官方文档：docs/zh_CN.md。

一个开源、透明、持续演进的工具，天然就有让人放心把整库音乐交给它的底气。

现在就动手，给音乐库补上最后一块拼图

从"深夜手工补歌词"到"一条命令全库搞定"，中间只差一次安装。

今晚就打开终端，选一个测试文件夹跑通第一条命令，你会发现：原来歌词批量下载可以这么安静、这么快。与其继续忍受空白的歌词区域，不如花三分钟给工具一个机会——好的工具不打扰你，它只是默默把事做完。

把时间留给音乐本身，把重复劳动交给 ZonyLrcToolsX。

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