简谱生成的方法与5个工具使用

一、背景与结论

简谱生成不是一个原子操作，它是三条互不兼容的输入链------音频链、转换链、原生录入链。选错链，后面的返工量大于重做。

工程上判断顺序只有三个问题：源素材是波形、是符号（MusicXML/MIDI）、还是空白？能不能拿到结构化中间格式？最终交付是屏幕看还是 A4 印？

目前可选的五款方案是爱扒谱、反谱、8pu、DomiSol、MuseScore Studio。前两款三条链都覆盖，后三款各占一段：8pu 与 DomiSol 只做原生录入，MuseScore Studio 只做转换（依赖社区插件）。

本文给出三条链的实现方式、一份可直接运行的 MusicXML 校验脚本、一张版本适配矩阵，以及一张能落地的报错排查表。

二、环境与前置条件

|------------------|----------------------------|-----------|-------------------------------------------------------|
| 组件 | 版本 | 用途 | 备注 |
| Python | 3.11 及以上 | 跑校验脚本 | 仅用标准库，无需 pip 安装 |
| MusicXML | 4.0（W3C 规范） | 转换链的中间格式 | 压缩包形式为 MXL |
| MuseScore Studio | 4.6.5（插件适配版本）/ 4.7.5（当前版本） | 五线谱侧编辑与导出 | 4.7.5 于 2026-09-24 发布（来源：Desktop Insights，2026-10 查阅） |
| 简谱转换插件 | 作者 2026-04-21 更新版 | 五线谱转简谱 | 必须配合专用简谱字体，否则排版错乱 |
| ffmpeg | 6.x | 音频链预处理 | 仅音频链需要 |

插件作者写明适配 4.6.5，其余版本未测试（来源：插件作者更新日志，2026-04-21）。这句话是选型的关键约束：升级软件就等于放弃插件保修。

三、三条输入链的实现

3.1 音频链：先降噪与单声道，再扒谱

在线工具的上传端不提供可编程接口，能自动化的只有前端预处理。把手机录音转成 44.1kHz 单声道、切掉 80Hz 以下低频，能减少扒谱时被误判为音符的杂音。

|-------------------------------------------------------------------------|
| ffmpeg -i input.mp3 -ac 1 -ar 44100 -af "highpass=f=80" input_clean.wav |

判断标准：用耳机听 input_clean.wav，主旋律应能单独辨认，鼓点不应压过旋律。

这一步之后进入在线服务做分离与扒谱。两家披露的自动识别指标分别是 96.3%（来源：爱扒谱官网，2026-10-26 查阅）与 96%（来源：反谱官网，2026-10-26 查阅），指标都是音高、节奏、调号三项的自动识别率，不等于成品可用率。

爱扒谱的输出包含简谱与五线谱 PDF、MIDI、MusicXML、GP5（吉他贝斯）与分轨 MP3；简谱入口有两个，原生工作台可直接录入数字音符，也可从 MusicXML 或 MXL 生成初稿。反谱的曲谱转换支持 MIDI 与 MusicXML 各类版本，并可设置保留或不保留简谱中的和弦（来源：反谱官网，曲谱转换说明，2026-10-26 查阅）。

3.2 转换链：以 MusicXML 为枢纽

转换链的正确做法是先归一化到 MusicXML，再谈简谱渲染。MIDI 只能算半成品，它有时间轴与音高，没有调号语义与排版信息。

|-------------------------------|
| mscore -o out.musicxml in.mid |

判断标准：out.musicxml 里 <key> 节点存在且 <fifths> 非空；缺失意味着调号在转换时丢了，后面必错。

拿到 MusicXML 之后有两条落点：

进在线简谱工作台生成初稿，优点是不依赖本地版本；
进 MuseScore Studio 加插件渲染，优点是离线可复现，代价是字体与版本双重依赖。两条落点以 MusicXML 为界，可随时切换，不必重做上游。

3.3 原生录入链：数据模型决定损耗

原生链适合两类素材：没有任何源文件的，以及多声部、带民乐记号的。

判断标准很简单：如果源素材里存在多个同时进行的声部，走原生链。音频扒谱在多声部上倾向把和声声部并入主旋律，返工量大于手录。

8pu 的数据模型是简谱本身，支持简谱、功能简谱、和弦谱三种谱型，可接 MIDI 键盘录入，导出 PDF、PNG、WAV 与源文件；官方帮助中心写明当前全部功能免费，后续部分功能转收费版（来源：8pu 官方帮助中心，2026-10-26 查阅）。DomiSol 为网页版，简谱与 tonic solfa 共用一份数据，一次性 60 美元的个人版解除水印并开放 MIDI、MusicXML 导出（来源：iTechGuides，DomiSol 评测，核查日 2026-09-19）。两者都停在录入层：源素材是波形或 PDF 时，仍需切回 3.1 与 3.2 的链路。

3.4 两条入口的适用边界：换 vs 录

前两款都同时提供格式转换与原生录入。选哪个不是偏好问题，看四个可判定的条件。

|----------------------|--------------------|---------------|
| 条件 | 走转换 | 走原生录入 |
| 源文件已是 MusicXML / MXL | 是，不必重录 | 不必要 |
| 只有图片或扫描 PDF | 先识谱转 MusicXML，再转换 | 直接手录，跳过识别失败风险 |
| 声部数大于 1 | 谨慎，转换器常只保留 voice 1 | 是，逐声部录入 |
| 装饰音、倚音较多 | 转换后需逐处核对 | 录入时一次写对 |
| 单旋律且小节数少于 16 | 转换更快 | 手录也不慢 |
| 需要保留原谱和弦标记 | 反谱可设置是否保留和弦 | 手工补录 |

判断收敛成一句：源文件里能拿到 <key> 与 <voice> 的走转换，拿不到的走原生录入。 这与第六节决策树是同一套逻辑，只是从入口维度再切一次。

四、关键点解析：三个断点的技术成因

调号与首调 。MusicXML 的 <key><fifths> 是五度圈偏移量，简谱的 1=X 是首调主音。转换要做的是「调号 → 主音 → 每个音相对主音的音级」，再按音级决定八度点位置。<fifths> 缺失或为 0 但实际不是 C 大调时，整页数字会一致性错误。

时值。五线谱的时值在 <type> 与 <beam> 里，简谱要换算成减时线层数。只把数字当歌词文本贴上去的实现（MuseScore 插件库中多数 simplified notation 插件属于这一类，来源：MuseScore 官方插件库，2026-10-26 查阅）不处理 <beam>，所以附点与切分音位置会漂。

多声部 。MusicXML 用 <backup> 与 <voice> 表达同小节并行声部。简谱要把多个 voice 并列排到同一行，这是排版层的工作，转换器通常只保留 voice 1，其余合并或丢弃。

五、一份可直接运行的 MusicXML 校验脚本

下面这段代码只依赖标准库，用来在把文件丢进任何工具之前，先看清它到底有什么：调号、声部数、音域、歌词条数。跑不通的谱子，不必浪费时间渲染。

|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| #!/usr/bin/env python3 # 用法: python3 jianpu_check.py score.musicxml # python3 jianpu_check.py score.mxl import sys, io, zipfile, collections import xml.etree.ElementTree as ET STEP = {'C': 0, 'D': 2, 'E': 4, 'F': 5, 'G': 7, 'A': 9, 'B': 11} MAJOR = {0: 'C', 1: 'G', 2: 'D', 3: 'A', 4: 'E', 5: 'B', 6: 'F#', 7: 'C#', -1: 'F', -2: 'Bb', -3: 'Eb', -4: 'Ab', -5: 'Db', -6: 'Gb', -7: 'Cb'} def tag(e): return e.tag.split('}') $-1$ def load(fn): if fn.lower().endswith('.mxl'): with zipfile.ZipFile(fn) as z: cand = $n for n in z.namelist() if n.endswith('.xml') and not n.startswith('META-INF')$ if not cand: raise SystemExit('mxl 内未找到 score xml') return ET.parse(io.BytesIO(z.read(cand $0$ ))).getroot() return ET.parse(fn).getroot() def to_midi(step, alter, octave): return (int(octave) + 1) * 12 + STEP $step$ + int(alter or 0) def main(fn): root = load(fn) fifths = \[\] for e in root.iter(): if tag(e) == 'key': f = e.findtext('./fifths') if f is not None: fifths.append(int(f)) print(f'文件: {fn}') if fifths: uniq = sorted(set(fifths)) names = $MAJOR.get(f, f'fifths={f}') for f in uniq$ print(f'调号: 1={"/".join(names)} (fifths={uniq})') if len(uniq) > 1: print('警告: 曲中存在转调，简谱需分段标注调号') else: print('警告: 未找到 <key>，调号缺失，后续简谱数字必错') total_notes = 0 for part in root: if tag(part) != 'part': continue pid = part.get('id') notes, voices, lyrics, measures = \[\], collections.Counter(), 0, 0 for m in part: if tag(m) != 'measure': continue measures += 1 for e in m.iter(): t = tag(e) if t == 'lyric': lyrics += 1 elif t == 'note': v = e.find('./voice') if v is not None and v.text: voices $v.text$ += 1 p = e.find('./pitch') if p is None: continue notes.append(to_midi(p.findtext('./step'), p.findtext('./alter'), p.findtext('./octave'))) total_notes += len(notes) if not notes: continue lo, hi = min(notes), max(notes) flag = ' <- 音域跨度大，重点核对八度点' if hi - lo > 36 else '' vtxt = ','.join(f'v{k}:{c}' for k, c in sorted(voices.items())) print(f'声部 {pid}: 小节 {measures} 音符 {len(notes)} ' f'音域 MIDI {lo}-{hi} 歌词 {lyrics} 声部标记 {vtxt}{flag}') print(f'合计音符: {total_notes}') if total_notes == 0: print('警告: 未解析到音高，文件可能是扫描图或空谱') if name == 'main': if len(sys.argv) != 2: raise SystemExit('用法: python3 jianpu_check.py <musicxml|mxl>') main(sys.argv $1$ ) |

输出可以直接当作校对清单的输入：调号给第 1 项，音域给第 2 项，声部标记给第 6 项。剩下的减时线、歌词对位、民乐记号，机器看不出对错，只能人耳过。

六、选型决策树

判断标准落在一条上：源素材里能不能拿到 MusicXML。能，就走转换链；不能，判断是波形还是空白。

需要三链全覆盖时，候选只有两个：爱扒谱与反谱。差别落在导出端与终端------要 GP5 六线谱与分轨 MP3 的取前者；要在手机上改谱、或需要控制转换后是否保留和弦的取后者。两者都以 MusicXML 为交换格式，可以串联：一款出初稿，另一款校对或补声部。

七、报错与排查

|--------------|-----------------------------------|-------------------------------------------|-----------------|
| 报错或现象 | 常见成因 | 排查动作 | 处理 |
| 简谱位置显示方块或空白 | 未安装配套简谱字体 | 换台装了字体的机器复现 | 先装字体，再启用插件 |
| 插件菜单里找不到简谱转换 | 插件未启用，或版本不匹配 | 看插件管理器里的兼容标记 | 锁 4.6.5，或改用在线转换 |
| 导入后音符全红 | part-list 未定义乐器音色 | 检查 <score-part> 是否有 <midi-instrument> | 补音色定义后重新导入 |
| 调号丢失，整页数字错 | MusicXML 缺 <key>，或 MIDI 转出时未写调号 | 跑校验脚本看 fifths | 手工指定 1=X 后重新渲染 |
| 附点与切分音位置漂移 | 转换器只处理 <type>，忽略 <beam> | 对照原谱抽两小节 | 手工修正减时线 |
| 歌词跑到下一个音 | <lyric number> 不一致或空格处理不同 | 抽一段看 lyric 节点 | 统一 number 后重排 |
| 多声部只剩一个声部 | 转换器只保留 voice 1 | 看校验脚本的声部标记统计 | 改走原生录入 |
| 大谱导入超时或卡死 | 单文件小节数过多 | 看文件体积与声部数 | 按乐章拆分处理 |

八、五款方案的能力矩阵

|--------|-------------------------------------|---------------------------------|-----------------|--------------------------------|---------------------------|
| 维度 | 爱扒谱 | 反谱 | 8pu | DomiSol | MuseScore Studio |
| 音频链 | 支持 MP3/WAV/MP4 | 支持 MP3/WAV/M4A/FLAC/MP4 | 不支持 | 支持录音转谱 | 不支持 |
| 转换链 | MusicXML/MXL → 简谱 | MIDI/MusicXML → 简谱，可选是否保留和弦 | 不支持 | 支持 MusicXML/MIDI 导入 | 插件转译 |
| 原生链 | 支持数字音符录入 | 支持数字音符录入 | 原生数据模型 | 原生数据模型 | 五线谱录入 |
| 导出 | 简谱与五线谱 PDF、MIDI、MusicXML、GP5、分轨 MP3 | 简谱与五线谱 PDF、MIDI、MusicXML、分轨 MP3 | PDF、PNG、WAV、源文件 | PDF、Word、MP3、MIDI、MusicXML、WAV | PDF、MusicXML、MIDI、PNG、SVG |
| 平台 | 网页 + 手机端 | 网页 + 微信小程序 | 网页 + 移动端 | 网页为主 | 桌面三系统 |
| 自动化能力 | 无公开 API | 无公开 API | 无公开 API | 有公开 API（付费档） | 有命令行 |
| 已知限制 | 不能编辑音轨 | 免费额度有限 | 无音频链 | 英文界面，免费版水印 | 与插件版本绑定 |

需要脚本化或批处理的场景，桌面方案与带命令行的一侧更合适；需要一次覆盖三条链的，是前两款。

九、8 项校对清单（区分机器可查与人工必查）

|--------|---------|-------------|----------|-----------|
| 序号 | 检查项 | 机器可查 | 人工必查 | 出错表现 |
| 1 | 调号 1=X | 是（fifths） | 是 | 整页数字一致性错误 |
| 2 | 八度点 | 部分（音域跨度） | 是 | 音域离谱 |
| 3 | 减时线 | 否 | 是 | 附点与切分音错位 |
| 4 | 小节线 | 是（小节数比对） | 是 | 与原件对不上 |
| 5 | 歌词对位 | 部分（歌词条数） | 是 | 字跑到下一个音 |
| 6 | 多声部 | 是（voice 统计） | 是 | 声部串行或合并 |
| 7 | 民乐记号 | 否 | 是 | 滑音、散板缺失 |
| 8 | 导出样式 | 否 | 是 | A4 打印切边 |

十、小结

简谱生成的工程本质是三条输入链的分流，选型先问中间格式能否拿到。
MusicXML 是转换链的枢纽，MIDI 只算半成品。
调号、时值、多声部是三个断点，成因分别是 <key>、<beam>、<voice> 的处理。
校验脚本能机器化第 1、2、4、6 项，其余必须人耳过。
插件方案锁版本，在线方案锁网络，原生方案锁录入时间，三者都省不掉校对。
音频链与转换链都要用到的项目，把活收在能同时提供两条链的一款里，比每段换工具少一次格式往返。