企业官网建设流程全解析

从单曲到整库：163MusicLyrics 歌词管理工具实操手册

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

163MusicLyrics 是一个开源的跨平台歌词下载与管理工具，支持网易云音乐和 QQ 音乐双平台搜索、批量匹配本地音乐，以及 LRC 与 SRT 格式互转。如果你需要为本地音乐库批量整理歌词，或者做视频时需要字幕格式，这套工具可以直接上手。

先判断：它适合你吗

另外两条准入条件：搜索与自动翻译需要联网；QQ 音乐的部分查询和百度/彩云翻译功能，需要在设置里先配置 Cookie 或 API 密钥。

一条工作流跑通核心功能

下面按"拿到一首歌 → 找到歌词 → 存成想要的格式 → 批量处理整库"的任务链走一遍，搜索、格式转换、批量、翻译都会嵌在流程里。

用链接或关键字定位单曲

打开主窗口，顶部有三个下拉框：搜索来源（网易云/QQ 音乐）、歌词格式（交错/独立/合并，用于双语歌词的展示方式）、搜索类型（单曲/专辑/歌单）。在输入框里粘贴歌曲页链接，或直接输入关键字，点"搜索"。命中后，中间区域会显示歌手、专辑、时长、发行日期，歌词正文在下方文本框里，还能用试听直链在线播放核对版本。

这里要注意：底部状态栏出现"命中本地缓存"时，说明这次结果来自本地缓存而不是网络请求，重复搜索同一首不会反复消耗接口配额。

模糊搜索与结果选择

只记得歌名片段或歌手时，勾选"模糊"再搜索。结果会以表格列出候选歌曲，字段包括歌曲、歌手、专辑、时长、平台，顶部提示"可多选后下载，右键列表也可操作"。勾选几首后点右上角"下载选中"，或右键使用菜单操作。

这里要注意：同一首歌常有 Live、Demo、翻唱等多个版本，结果偏多时把歌手名或专辑名一起写进关键字可以明显收窄范围；实在分不清就用歌曲链接做精确查询。

选定歌词格式再保存

保存前先看底部两个下拉框：输出格式（LRC 给播放器，SRT 给视频剪辑）和文件编码（默认 UTF-8）。文件名由模板生成，默认样式是"歌名 - 歌手"，可以在设置里改成"歌手 - 专辑 - 歌名"这类层级。点"保存"后弹出目录选择框：

这里要注意：目录选择框里"文件名"一栏直接选目录即可，不需要手填；同名文件是覆盖还是自动加编号，在设置的"同名文件处理策略"里定，选"自动追加编号"可以避免覆盖已手工改过的歌词。

如果你手上已有一批现成的 LRC 文件想转成 SRT（或反过来），不用走搜索，直接用顶部菜单的"格式转换"，把文件导进去批量转换即可。

批量匹配本地音乐库

整库处理走"下载管理"窗口（主窗口右上角按钮进入）。它有两种入口：在顶部输入框粘贴多条歌曲链接（逗号分隔），或点"本地扫描"选一个音乐文件夹，程序会读取文件名和音频标签来解析歌曲信息：

扫描后所有条目进入列表，状态列显示 Ready 表示可保存，备注列会标出失败原因。勾选目标行点"保存选中"，底部状态栏实时汇总"累计保存歌曲数量、保存成功/失败"。

这里要注意：备注里出现"歌词信息未被收录或查询失败"的条目不用反复重试，通常是平台没收录该版本的歌词，换一首平台来源或跳过即可。

上手三步

第一步：拿到工具。从源码构建：

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

也可以直接在项目的 Release 页面下载已构建好的安装包，覆盖 Windows、macOS、Linux，不需要自己编译。

第二步：选择工作模式。单曲查询走主窗口搜索；有一批链接就进"下载管理"粘贴；有本地文件夹就用"本地扫描"；要整个歌单的歌词，把搜索类型切到"歌单"。

第三步：配置输出。打开"更多设置"，按需调整：输出格式与编码、文件名模板、同名文件策略、搜索缓存目录与大小上限（默认 128MB）、代理模式。需要自动翻译的，把百度翻译的 AppId/Secret 或彩云小译的 Token 填进对应位置，之后保存的歌词可以按"原文/中文译文/英文译文/音译/拼音"自由组合输出。

排错与避坑

1. 现象：搜索后列表里状态正常，但备注显示"歌词信息未被收录或查询失败"。原因：该歌曲或该版本没有收录在所选平台。处理：切换搜索来源到另一家平台重试，或改用专辑/歌单方式查询。

2. 现象：模糊搜索结果太多，找不到目标歌。原因：同名歌曲存在多个版本（Live、Demo、翻唱、纯音乐）。处理：关键字里同时写歌手名和专辑名；纯音乐在保存时会被默认跳过（"保存时跳过纯音乐"）。

3. 现象：QQ 音乐搜索偶发失败或结果缺失。原因：QQ 音乐接口对部分查询有登录态限制。处理：在设置的 Cookie 配置项里填入 QQ 音乐的 Cookie 后重试。

4. 现象：保存出来的歌词只有原文，没有译文。原因：翻译密钥（百度 AppId/Secret 或彩云 Token）未配置，或该歌本身缺译文。处理：补齐对应密钥；也可在"译文缺省规则"里选择忽略、展示空行或填充原文。

项目结构速览

• cross-platform/MusicLyricApp/：跨平台主程序（Avalonia + MVVM），入口在 Program.cs
• cross-platform/MusicLyricApp/Core/Service/Music/：网易云与 QQ 音乐双平台 API 实现，搜索逻辑在 SearchService.cs
• cross-platform/MusicLyricApp/Core/Utils/：歌词处理核心，SrtUtils.cs 里的 LrcToSrt 就是 LRC 转 SRT 的实现
• cross-platform/MusicLyricApp.Tests/：单元测试
• archive-winform/：已归档的旧 WinForms 版本，做参考用

参与项目

• 功能建议或 Bug 反馈，通过项目页面的 Issue 提交，写清复现步骤
• 修复 Bug 或加功能：Fork 仓库后提交 Pull Request
• 使用文档和界面翻译也欢迎认领
• 项目采用 Apache 2.0 协议

下一步

• 先用"单曲搜索"跑通一次，确认保存出的 .lrc 能被你的播放器正常读取
• 配置好文件名模板和保存目录后，拿 10 首本地歌曲试一次模糊搜索，检查匹配准确率
• 批量处理时先在一个几十首歌的小目录上验证成功率和失败原因，再对整个音乐库开跑

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