1628 字

8 分钟

M4A音乐自动提取歌词与封面教程

2026-05-16

博客指南

使用文档

音乐

浏览量加载中...

AI 摘要

M4A 音乐自动提取歌词与封面教程#

背景#

博客的音乐收藏页面（/music）需要为每首歌准备三样东西：

文件	用途
`.m4a` / `.mp3`	音频文件本身
`.lrc`	同步歌词（带时间轴的歌词文件）
`.jpg`	专辑封面图
`.md`	博客的 Markdown 内容文件

手动搜歌词、下载封面、写 md 实在太麻烦。我写了一套脚本，两种方式一条命令全部搞定。

两种使用模式#

脚本 fetch-lrc.py 支持两种模式：

模式	使用场景	命令
本地文件模式	已有 M4A 文件，提取内嵌封面+API 下载歌词	`python fetch-lrc.py song.m4a --md`
搜索下载模式	没有本地文件，直接搜歌名下载音频+封面+歌词	`python fetch-lrc.py "晴天" "周杰伦" --md`

工作原理#

flowchart TD A[输入] --> B{是文件路径?} B -->|是| C[读取 M4A 元数据] C --> D{内嵌封面?} D -->|有| E[提取封面] D -->|无| F[Meting API 搜索] B -->|否| G[搜歌名下载模式] G --> H[Meting API 搜索] H --> I[显示搜索结果列表] I --> J[用户选择/自动选第一首] J --> K[下载音频] K --> L[下载封面] L --> M[下载歌词] M --> N[生成 MD] F --> L E --> M

本地文件模式：读取 M4A 元数据（歌名、歌手）→ 提取内嵌封面 → API 搜索 → 下载歌词 → 生成 md
搜索下载模式：输入歌名搜索 → 选择结果 → 下载音频 → 下载封面 → 下载歌词 → 生成 md

环境准备#

安装依赖#

需要 Python 3 和 mutagen 库：

1
pip install mutagen

注意：Windows 上可能有多个 Python 版本，确保用装过 mutagen 的那个。可以用完整路径指定，如 C:/Users/xxx/AppData/Local/Programs/Python/Python313/python.exe

无需 ffmpeg，纯 Python 实现。

使用方法#

本地文件模式#

1
# 处理单个文件
2
python scripts/fetch-lrc.py "path/to/song.m4a" --md
3

4
# 处理整个目录（批量）
5
python scripts/fetch-lrc.py "path/to/music/folder" --md

脚本会遍历目录下所有 .m4a、.mp3、.flac 等文件，逐个提取封面和下载歌词。

搜索下载模式#

1
# 只搜歌名
2
python scripts/fetch-lrc.py "晴天" --md
3

4
# 歌名 + 歌手（提高准确度）
5
python scripts/fetch-lrc.py "海阔天空" "Beyond" --md
6

7
# 换平台
8
python scripts/fetch-lrc.py "起风了" --md --server=kugou
9

10
# 指定下载目录
11
python scripts/fetch-lrc.py "晴天" "周杰伦" --md --out=./downloads
12

13
# 只搜索预览（不下载）
14
python scripts/fetch-lrc.py "晴天" --dry-run

搜索结果有多条时会显示列表，交互模式下可手动选择序号，非交互终端自动选第一首。

完整参数表#

参数	说明	默认值
第一个参数	M4A 文件路径 / 歌名	必填
第二个参数	歌手名（搜索模式）	空
`--md`	生成博客 md 文件到 `src/content/bangumi/music/`	关闭
`--no-md`	只提取/下载，不生成 md	-
`--server=xxx`	音乐平台	`netease`
`--audio-base=xxx`	自定义 URL 前缀	`https://ph.0824.uk/file/music/`
`--md-dir=xxx`	自定义 md 输出目录	`src/content/bangumi/music/`
`--out=xxx`	搜索模式的下载目录	`scripts/downloads/`
`--dry-run`	搜索模式只预览，不下载	-

支持的平台#

值	平台
`netease`	网易云音乐
`tencent`	QQ 音乐
`kugou`	酷狗音乐
`baidu`	百度音乐
`kuwo`	酷我音乐

实操示例：本地文件模式#

以歌曲《暗恋过结局呢》为例。

第一步：准备 M4A 文件#

将 M4A 文件放到任意目录，例如 scripts/zcyyy/：

1
scripts/zcyyy/
2
└── 暗恋过结局呢.m4a

第二步：运行脚本#

1
python scripts/fetch-lrc.py scripts/zcyyy --md

第三步：查看输出#

1
scripts/zcyyy/
2
├── 暗恋过结局呢.m4a    ← 原始文件
3
├── 暗恋过结局呢.lrc    ← API 下载的同步歌词
4
└── 暗恋过结局呢.jpg    ← API 下载的封面图
5

6
src/content/bangumi/music/
7
└── 暗恋过 结局呢.md    ← 自动生成的博客内容文件

实操示例：搜索下载模式#

以歌曲《知我》为例。

第一步：运行命令#

1
python scripts/fetch-lrc.py "知我" "哦漏" --md

第二步：选择结果#

1
搜索: 知我 - 哦漏
2

3
搜索结果:
4

5
  [ 1] 知我 - 国风堂 / 哦漏
6
  [ 2] 知我 (伴奏) - 国风堂 / 哦漏
7
  ...
8

9
选择序号 (1-2, 默认 1): 1
10

11
选中: 知我 - 国风堂 / 哦漏
12
  音频 [100%] =========================> 11 MB/11 MB
13
  [封面] 知我-国风堂哦漏.jpg
14
  [歌词] 知我-国风堂哦漏.lrc (1950 字符)
15
  [MD] 知我.md

第三步：输出文件#

1
scripts/downloads/
2
├── 知我-国风堂哦漏.m4a    ← 下载的音频
3
├── 知我-国风堂哦漏.jpg    ← 封面图
4
└── 知我-国风堂哦漏.lrc    ← 同步歌词
5

6
src/content/bangumi/music/
7
└── 知我.md               ← 自动生成的博客内容文件

生成的 Markdown 格式#

1
---
2
title: 知我
3
category: music
4
status: 2
5
image: https://ph.0824.uk/file/music/知我-国风堂哦漏.jpg
6
artist: 国风堂 / 哦漏
7
audioUrl: https://ph.0824.uk/file/music/知我-国风堂哦漏.m4a
8
lrcUrl: https://ph.0824.uk/file/music/知我-国风堂哦漏.lrc
9
score: 0
10
published: 2026-05-16
11
---

生成后手动调整 score（评分）、status（状态）、title（清理多余空格）即可。

状态码含义：

值	含义
`1`	想听
`2`	听过
`3`	在听
`4`	搁置
`5`	弃了

批量处理#

1
# 批量处理本地 M4A 文件
2
python scripts/fetch-lrc.py D:/Music/ --md
3

4
# 批量下载歌单（需提前准备好歌名列表，自行写批处理循环）

已处理的文件会自动跳过（封面、歌词、md 已存在则不再重复生成）。如需重新生成，先删除已有文件即可。

常见问题#

Q: 歌词下载失败？#

换个平台试试：

1
python scripts/fetch-lrc.py song.m4a --md --server=kugou

Q: 搜索下载模式下无法手动选择？#

非交互终端（如管道执行）会自动选第一首。手动终端用 PowerShell 或 CMD 打开运行即可交互选择。

Q: 音频下载失败？#

某些热门歌曲因版权限制，Meting API 可能返回 404。尝试换平台搜索：

1
python scripts/fetch-lrc.py "晴天" "周杰伦" --md --server=kugou

Q: 封面不对？#

本地文件模式优先使用 M4A 内嵌封面。如果内嵌封面不对，删除自动生成的 .jpg 后重新运行即可从 API 下载。

Q: 文件名有空格和特殊符号？#

最新版脚本会自动清理文件名中的空格和特殊字符，确保 URL 合法。

Q: 不想生成 md？#

1
python scripts/fetch-lrc.py song.m4a --no-md

Q: URL 前缀怎么改？#

1
python scripts/fetch-lrc.py song.m4a --md --audio-base=https://你的cdn.com/music/

Q: pip install mutagen 后还是报 ModuleNotFoundError？#

Windows 上可能有多个 Python 版本。检查方式：

1
# 查看当前 python 路径
2
where python
3

4
# 用装过 mutagen 的那个 Python 执行
5
C:/完整路径/python.exe scripts/fetch-lrc.py ...

总结#

操作	命令
本地文件 → 歌词+封面	`python scripts/fetch-lrc.py song.m4a --md`
批量导入本地文件	`python scripts/fetch-lrc.py ./music-folder/ --md`
直接搜歌下载	`python scripts/fetch-lrc.py "晴天" "周杰伦" --md`
只要音频+封面+歌词	`python scripts/fetch-lrc.py "晴天" --no-md`
换个平台搜	`python scripts/fetch-lrc.py "晴天" --md --server=kugou`

整个流程只需一条命令，博客音乐收藏页面就自动上线新歌了。

支持与分享

如果这篇文章对你有帮助，欢迎分享给更多人或赞助支持！

赞助

M4A音乐自动提取歌词与封面教程

https://blog.tsh520.cn/posts/博客指南/m4a音乐自动提取歌词封面教程/

作者

团子和蛋糕

发布于

2026-05-16

许可协议

CC BY-NC-SA 4.0

最后更新于 2026-05-16，距今已过 35 天

部分内容可能已过时

Maven概述与核心作用

Maven模型与仓库

评论区

[ 标签 ]

# AI 1 # Ajax 2 # Apifox 1 # Astro 2 # claudecode 1 # CloudFlare 1 # CSS 6 # DELETE 1 # Gist 1 # GitHub 1 # HTML 6 # HTTP 2 # Java 23 # java 13 # JavaScript 5 # JDBC 3 # JSON 1 # JUnit 1 # Logback 1 # Maven 6 # Mybatis 1 # MyBatis 4 # MySQL 6 # MySql 1 # Obsidian 1 # ORM 1 # PathVariable 1 # PicGo 1 # RequestBody 1 # RequestMapping 1 # RESTful风格 1 # Slf4j 1 # SpringBoot 11 # SQL 2 # Svelte 1 # TailwindCSS 1 # Telegram 1 # Tlias 2 # Vue 7 # Web基础 6 # YAML 1 # 三层架构 1 # 使用文档 7 # 刷步数 1 # 前端 32 # 单词 1 # 博客 2 # 博客开发 1 # 参数接收 1 # 后端 1 # 图床 1 # 存储 1 # 学习方法 1 # 导航栏 1 # 工具 1 # 开发 1 # 开发规范 1 # 开心 1 # 影视 1 # 想法 3 # 感悟 4 # 数据库 10 # 日常 13 # 日志框架 1 # 生活迁移 1 # 电影 1 # 碎碎念 1 # 网络教室 1 # 蓝奏云 1 # 记录 1 # 词根 1 # 词缀 1 # 路径参数 1 # 运动 1 # 配置 1 # 音乐 1 # 音标 1 # 驼峰命名 1

[ 分类 ]

# 编程学习 63 # 博客指南 8 # 技术分享 6 # 英语笔记本 5 # AI使用 1 # 资源整理 1

[ 公告 ]

如果你喜欢，那么欢迎来到我的世界！

了解更多

[ 音乐 ]

找不到相关结果。

[ contents ]

[ 全部文章 ]

M4A音乐自动提取歌词与封面教程

M4A 音乐自动提取歌词与封面教程#

背景#

两种使用模式#

工作原理#

环境准备#

安装依赖#

使用方法#

本地文件模式#

搜索下载模式#

完整参数表#

支持的平台#

实操示例：本地文件模式#

第一步：准备 M4A 文件#

第二步：运行脚本#

第三步：查看输出#

实操示例：搜索下载模式#

第一步：运行命令#

第二步：选择结果#

第三步：输出文件#

生成的 Markdown 格式#

批量处理#

常见问题#

Q: 歌词下载失败？#

Q: 搜索下载模式下无法手动选择？#

Q: 音频下载失败？#

Q: 封面不对？#

Q: 文件名有空格和特殊符号？#

Q: 不想生成 md？#

Q: URL 前缀怎么改？#

Q: pip install mutagen 后还是报 ModuleNotFoundError？#

总结#

支持与分享

相关阅读

评论区

音乐