企业官网建设流程全解析

用 LRCGET 批量下载同步歌词，10 分钟给 1000 首本地歌曲快速配齐

【免费下载链接】lrcgetUtility for mass-downloading LRC synced lyrics for your offline music library.项目地址: https://gitcode.com/gh_mirrors/lr/lrcget

周五晚上，你从抽屉里翻出那块 1TB 的移动硬盘，里面躺着 2000 多首歌，却没有一首带同步歌词。

LRCGET 就是干这个的：它是开源歌词库 LRCLIB 的官方客户端，用 Tauri（Rust 后端加前端 WebView 的桌面应用框架）写成，支持 Windows、macOS、Linux，当前版本 v2.1.0。它扫描你指定的整个音乐目录，批量下载同步歌词，保存为与歌曲同名的 .lrc 文件，全程不用逐首操作。

先用 1 分钟看懂它

• 跑通「安装 → 添加目录 → 整库批量拉取 → 播放验证」完整流程，约 10 分钟；
• 认识三种状态标记：Synced（同步歌词）、Plain（纯文本）、Instrumental（纯音乐）；
• 理解增量扫描机制，明白第二次启动为什么只要几秒；
• 避开批量下载匹配失败、Linux 无声等 4 个常见坑。

快速上手：从安装到第一次成功运行

1. 下载并安装对应平台的版本

Windows 选 EXE 安装程序，macOS 按芯片选 Intel 或 Apple Silicon 的 DMG，Linux 优先 Flatpak，另有 Deb、RPM、AppImage 可选。装完双击启动，首次运行会直接停在目录选择页。

2. 添加音乐目录，等待扫描

点「添加目录」选一个存放音乐的文件夹，嵌套子目录会被自动递归识别，MP3、FLAC、M4A 等常见格式都会被抓到。看到 Tracks、Albums、Artists 三个页签和歌曲总数出现，说明扫描完成。

3. 启动整库批量拉取歌词

点右上角粉色「DOWNLOAD ALL LYRICS」按钮。弹窗实时显示进度条和三组数字：FOUND、NOT FOUND、TOTAL。期间可以照常播放试听，随时点 STOP 中止。

4. 播放验证同步歌词

双击任意歌曲，底部面板逐行滚动、当前行高亮；该行右侧出现绿色 Synced 标记，说明这一首已经配齐。

关键机制：三种状态标记与增量扫描

状态标记

是什么：每条曲目右侧有一个标签。Synced 表示带逐行时间戳的同步歌词，Plain 表示只有纯文本歌词，Instrumental 表示被识别为纯音乐、本来就没有歌词。

为什么重要：全库几千首歌，扫一眼就知道哪些已配齐、哪些缺文本、哪些不用管，不用逐首点开核对。

界面上怎么看：Tracks 列表每行右侧的彩色标签；搜索框旁的筛选下拉框可以只圈出缺同步歌词的歌，方便分批处理。

增量扫描

是什么：扫描时为每个文件记录大小、修改时间，并对文件头 64KB 做 xxhash3 内容哈希（一种极快的文件指纹算法）。

为什么重要：文件被移动、改名、新增都能被精确识别，重扫只处理变化部分。官方数据是 10 万个文件在机械硬盘上约 30～90 秒，SSD 上 5～10 秒。

界面上怎么看：扫描过程分 discovering、updating 两个阶段显示进度；结束时报告新增、修改、删除、未变四个数字。

进阶技巧

入门

• 单曲精准搜索：对显示 Not Found 的歌，点该行行尾的搜索图标，弹窗里手动修正标题、艺术家、专辑后重新搜索。结果会区分同步与纯文本两类，可预览内容后选取最合适的版本下载。
• 整库导出：点右上角导出图标，菜单有三个勾选项——Plain lyrics (.txt)、Synced lyrics (.lrc)、Embed into track，按需勾选后点 EXPORT，把已下载的歌词批量写回歌曲目录。

进阶

• 毫秒级校准：在歌曲行点编辑图标打开同步歌词编辑器，每行时间戳旁的 +/− 按钮可以逐毫秒微调；点行首播放按钮回放该句，边听边对齐。
• 发布与举报：编辑器左上角 SAVE 下拉里有「Save and Publish」，把改好的歌词提交到 LRCLIB 供他人使用；LRCLIB 页签里还能浏览远端歌词并对明显错误的内容发起举报。

极客

• 歌词嵌入音频：导出时勾「Embed into track」，MP3 写 ID3 标签、FLAC 写 Vorbis 注释，歌词跟着文件走，备份时不会遗漏。
• 私有词库：设置里可把 LRCLIB 实例地址指向自建部署，搜索、下载、发布全部走私有库。

实战演练：给 1000 首歌的车载硬盘配齐歌词

1. 把硬盘里的音乐文件夹添加为音乐目录，等首次扫描完成，确认歌曲总数；
2. 用筛选下拉框圈出缺同步歌词的歌，分 3～4 批、每批 250～300 首处理，方便跟踪进度；
3. 每批点「DOWNLOAD ALL LYRICS」，盯住弹窗三组数字：FOUND（已找到）、NOT FOUND（未找到）、TOTAL（总数）。绿色行是成功，红色行会写明原因，比如 Not Found 或标记为纯音乐；
4. 批次跑完，对红色清单里的歌逐首用「搜索歌词」补救，最后统一导出，连歌带 .lrc 拷回车载设备。

耗时预估：扫描环节按 10 万文件计，HDD 约 30～90 秒；下载主要取决于网速，按每首 1～2 秒算，1000 首大致半小时量级，正好一顿饭的功夫。

常见问题

某首歌显示 Not Found原因：文件名或元数据与 LRCLIB 库中的标题对不上。解决：点该行「搜索歌词」图标，手动修正标题、艺术家、专辑后重新搜索，从结果里选取版本下载。

Linux 上播放没有声音原因：系统缺少 ALSA 兼容层，音频无法路由。解决：Ubuntu/Debian 下执行sudo apt install pipewire-alsa，重启应用即可出声。

Windows 上应用打不开原因：LTSC 或精简脚本卸载了 Microsoft Edge 的 WebView2 运行时，而 Tauri 应用依赖它。解决：重新安装 Microsoft Edge，恢复 WebView2 组件后重启应用。

KDE Plasma 下表滚动条看不见原因：Plasma 5/6 的主题渲染与 WebView 存在兼容问题。解决：系统设置 → 外观 → 全局主题 → 应用程序样式，把 breeze 换成 Awaita 或 Default 再应用。

延伸资料

• 前端架构文档：src/ARCHITECTURE.md
• 后端架构文档（数据库、扫描算法、事件流）：src-tauri/ARCHITECTURE.md
• 增量扫描器源码：src-tauri/src/scanner/
• LRCLIB 接口封装（搜索、发布、PoW 校验）：src-tauri/src/lrclib/
• LRC 解析器：src-tauri/src/parser/lrc.rs

对 Tauri + Rust 桌面开发感兴趣的话，可以直接克隆仓库参与贡献：

git clone https://gitcode.com/gh_mirrors/lr/lrcget

那块硬盘重新插上时，2000 首歌每一首都跟着旋律一行行亮起了歌词。🎵

【免费下载链接】lrcgetUtility for mass-downloading LRC synced lyrics for your offline music library.项目地址: https://gitcode.com/gh_mirrors/lr/lrcget