前阵子一个朋友给我一份简谱1C4/4拍排练时想让主唱试试F调问我能不能把整张谱子转一下。打印出来看了一眼虽说只有两页但真手写转调的话每个音都要单独换算碰上高低音点和临时升降号更是算得头皮发麻。正好谱子在我电脑里是纯文本形式我就想干脆写个Python小脚本把简谱转调这件事自动化。这就是这篇博文的由来用Python程序实现简谱转调把“数字谱面”从旧调整体搬到新调。说白了简谱里的1、2、3并不是固定音高而是调内的音级转调的本质是先把每个音换算成绝对音高再搬进新调的记谱体系。这篇文章会从音乐理论、输入格式设计、核心算法、记谱规范化到完整验证走一遍最后附上可以直接拿去用的脚本。适合有一定Python基础、偶尔要和简谱打交道的人——无论是做歌谱整理、乐器分谱还是帮人声翻唱换调都能用得上。1. 简谱转调为什么不能直接“数字加几”先搞清楚首调与绝对音高1.1 简谱数字是调内音级不是固定音高简谱是典型的首调记谱法。1C意思是把C音唱成do1G就是把G音唱成do。同一串“1 2 3 5”在不同调里对应的绝对音高完全不同。举个例子C调下的“1 2 3 5”分别是C、D、E、G而G调下的“1 2 3 5”是G、A、B、D。数字没变实际音高整体高了一截。这个特点对写代码的人来说是个关键认知程序如果要转调不能把“1”当成一个固定值去处理必须先知道这个“1”代表哪个调的主音。我最早试图写转调程序时踩过这个坑以为简谱转调就是把每个数字做加减法后来发现完全不是这么回事。不同调下简谱数字与音名的对应大致如下表简谱数字1C时1D时1G时1CDG2DEA3EF#B4FGC5GAD6ABE7BC#F#可以看到同一个数字“4”在C调是F在D调是G在G调是C。如果把“数字几”当成算法核心这个映射关系根本处理不了。1.2 两种转调需求改调号不动数字还是重新映射数字实际生活中“转调”其实有两种常见需求一开始要分清楚。第一种整体换调号但数字不变。这种场景最常见于人声翻唱一首歌原调1E主唱音域唱不上去想降到1D但旋律线条、唱名关系都不变只是绝对音高整体降低两个半音。这时最省事的做法是把谱子开头的“1E”改成“1D”音符数字原样保留。也就是“只改调号数字不动”。第二种重新映射数字。这种常见于器乐改编或需要把谱子翻译成另一种记谱习惯的场景。绝对音高序列保持原样但要在新调里给每个音重新找数字。比如C调旋律里的G音到了D调里就要写成4因为D调里4是G音。两种需求都值得程序支持。本文的核心算法默认做第二种“重新映射数字”因为它的技术含量更高处理好了以后第一种需求只需要顺手把调号替换一下就能实现。后面我会单独讲“稳定模式”。1.3 一个手工换算例子C调4转到D调为什么是#3先手工推一个例子感受一下“重新映射数字”到底在算什么。C调里的“4”是F音。现在要把它写进D调。D调的音级音名是D、E、F#、G、A、B、C#对应数字1到7。F这个音比D调的3E高一个半音比D调的4F#低一个半音。也就是说它在D调里既接近3又接近4实际写成“#3”或“b4”都说得过去。你看光靠“数字2”是绝对推不出“#3”或者“b4”的。这就是为什么程序不能只对数字做加减而要把每个音符先还原成绝对音高再在新调体系里重新匹配音级。理解了这一点后面的算法设计就顺理成章了。2. 输入格式设计把简谱文本变成可计算的音符事件2.1 事件模型音级、八度偏移、变音符号程序要处理的最小颗粒是“音符事件”。我把一个音符事件定义成一个简单的四元组音级数字1到7、八度偏移0表示中音1表示高音点-1表示低音点、变音符号-1降、0自然、1升。为什么要把音符拆得这么细因为简谱文本里除了音符还有大量跟音高无关的内容——小节线、拍号、延音线、休止符、附点。这些内容在转调时都应该原样保留唯一需要变化的只有音高信息。事件模型拆细以后程序就专注于替换“音符token”其他字符一概不动。比如“| 1 2 3 5 |”这行文本小节线“|”和空格原样保留“1 2 3 5”这四个数字分别构成四个音符事件转调算法只需要调整这四个事件。2.2 文本规范空格分隔的token高低音点与升降号怎么写为了让程序解析简单可靠我建议输入谱采用一种很宽松的文本规范但不是没有规矩。基本格式是这样的1C 4/4 1 2 3 5 | 6 5 3 1 | 5 3 2 - | 1 - - 0 |几个约定音符与音符之间用空格分隔不要连写。比如“56”想表达两个八分音符请写成“5 6”。这是为了让正则能稳定识别独立音符token。高音点用数字后面的撇号表示比如“5”是高音5低音点用数字后面的逗号表示比如“3,”是低音3。升降号写在数字前面#4表示升4b7表示降7。拍号请连写比如“4/4”中间不要有空格这样正则不会把拍号里的数字当成音符。休止符0、延音线-、附点.、小节线|原样保留。这个规范不算苛刻大部分从打谱软件导出的文本简谱稍作整理就能满足。附点这类符号我让音符token允许后面带一个点解析时先把点拆出来转调之后再原样拼回去。2.3 解析与回写parse_note 和 format_note有了文本规范解析就很简单。核心函数就两个一个把token拆开一个把音符事件拼回token。import re # 音符token可选升降号 数字1-7 可选高低音点 可选附点 NOTE_RE re.compile(r(?!\S)[#b]?[1-7][\,]?\.?(?!\S)) def parse_note(token): 把 b3, 这样的token解析成 (degree, oct_shift, accidental) m re.fullmatch(r([#b]?)([1-7])([\,]?)(\.?), token) if not m: raise ValueError(f无法解析音符token: {token}) accident, degree_char, octave_mark, dot m.groups() degree int(degree_char) accidental {#: 1, b: -1}.get(accident, 0) octave_shift 0 if octave_mark : octave_shift 1 elif octave_mark ,: octave_shift -1 return degree, octave_shift, accidental, dot def format_note(degree, octave_shift, accidental, dot): 把音符事件重新拼成token acc_char {1: #, -1: b, 0: }[accidental] octave_char {1: , -1: ,, 0: }[octave_shift] return f{acc_char}{degree}{octave_char}{dot}注意正则里的边界控制(?!\S)和(?!\S)这能避免把“4/4”里的4误判成音符token。这个细节特别重要后面我会专门讲。3. 核心算法实现绝对音高平移与新调音级的反向查找3.1 为什么用MIDI编号做中间表示音符已经解析成“音级、八度偏移、变音符号”了接下来要找一个中间表示让“平移”变得简单。我选的是MIDI编号。MIDI编号把每个半音映射成一个连续整数中央C是60相邻半音差1。这样转调就变成了一次纯粹的加法新MIDI 旧MIDI 偏移量。偏移量就是新旧调主音之间的半音差。为什么不用音名做中间表示因为音名有等音问题比如F和E#是同一个音高程序处理起来容易绕晕。MIDI编号没有这个问题同一个音高只有一个编号干净利落。先定义两个基础映射表# 自然大调各音级相对主音的半音数 SCALE_SEMITONES {1: 0, 2: 2, 3: 4, 4: 5, 5: 7, 6: 9, 7: 11} # 调名 - 主音半音数以C为0 KEY_SEMITONES { C: 0, C#: 1, Db: 1, D: 2, D#: 3, Eb: 3, E: 4, F: 5, F#: 6, Gb: 6, G: 7, G#: 8, Ab: 8, A: 9, A#: 10, Bb: 10, B: 11, Cb: 11, } def normalize_key(key_name): 兼容 bB、#F 这类写法统一转成 Bb、F# 风格 if len(key_name) 2 and key_name[0] in #b: return key_name[1] key_name[0] return key_name自然大调音阶里1到2是全音2到3是全音3到4是半音4到5是全音5到6是全音6到7是全音7到1是半音。这些数值就是上面SCALE_SEMITONES的来源。以后如果想支持小调或五声音阶只要换这张表就行。3.2 note_to_midi 与 midi_to_note音符到MIDI编号的计算可以这样理解先确定调主音在中央C八度里的MIDI基准再叠加上音级半音偏移、八度偏移和变音符号。MIDDLE_C_OCTAVE 60 # 中央C的MIDI编号 def note_to_midi(degree, octave_shift, accidental, key_semi): 音符事件转MIDI编号 root key_semi MIDDLE_C_OCTAVE return root SCALE_SEMITONES[degree] accidental octave_shift * 12这里的关键是“root”的算法。比如1DD的主音半音是2root就是62正好是D4的MIDI编号“1”在这个调里就是D4完全正确。反向查找是算法的核心。拿到MIDI编号后先算出它相对于新调主音的偏移然后在新调音阶里找到最接近的自然音级。这里有一个“最接近”的细节我会在下一章单独讲先看基础实现def midi_to_note(midi, key_semi): MIDI编号转回音符事件 diff midi - (key_semi MIDDLE_C_OCTAVE) octave_shift diff // 12 semi diff % 12 best_degree 1 best_diff 99 for degree, semitone in SCALE_SEMITONES.items(): d (semi - semitone 6) % 12 - 6 if abs(d) abs(best_diff): best_diff d best_degree degree accidental best_diff return best_degree, octave_shift, accidental比如C调的5G4MIDI 67转到D调新调主音半音是2root62diff5semi5自然音级里第4级是5所以得到4自动升号0。输出就是“4”。这个结果和实际情况完全一致。3.3 负数八度的正确性Python取模和整除的配合转调中最容易出错的是低音区。C调的低音6A3MIDI 57转到D调diff 57 - 62 -5。这里我用的是Python的//和%octave_shift -5 // 12 -1semi -5 % 12 7。也就是说这个音在新调里是低音区的5A3。手动推理一下D调的低音5正好是A3正确。如果换成C语言那套“整数除法截断取整”的思路-5 // 12会变成0音级直接算错。所以选Python做这类工具很省心取模和整除对负数天然是配套的。这个细节值得记一下别在转调后看到低音点才发现出了问题。4. 转调结果规范化升降号取舍与八度稳定性4.1 等音选择同一个音高在新调里到底记升号还是降号上一章的反向查找有一个隐患当半音偏移落在两个自然音级正中间时同一个音高可能有两种写法。比如C调的4F转到D调MIDI算下来会让音级选择在3和4之间摇摆既可能写成#3也可能写成b4。发声完全一样但记谱习惯不同。我的做法是做一个简单的倾向性策略如果目标调是升号调比如G、D、A、E、B、F#就优先选升号写法如果目标调是降号调比如F、Bb、Eb、Ab就优先选降号写法C调本身默认走降号写法。这个偏好和五度圈直觉一致。def choose_degree_with_tendency(semi, key_name): 根据目标调的调号倾向决定等音写法 best_degree 1 best_diff 99 for degree, semitone in SCALE_SEMITONES.items(): d (semi - semitone 6) % 12 - 6 if abs(d) abs(best_diff): best_diff d best_degree degree elif abs(d) abs(best_diff): # 平局时根据调号方向选择 if # in key_name and d 0: best_degree degree best_diff d elif b in key_name and d 0: best_degree degree best_diff d return best_degree, best_diff实际效果是什么比如D调是升号调碰到F音这种可能写成#3的程序会倾向升号如果是Bb调碰到类似位置会倾向降号写法。这样输出的谱面更符合读谱习惯。当然如果你只是想要绝对音高正确不讲究记谱风格这个策略可以完全省略。4.2 整行八度整体修正转调后谱面别全往低音区跑还有一个很实际的问题转调后音符的八度分布可能会大幅偏移。比如一首1E的谱子整体降到1C很多音符会落到低音区满屏都是逗号看着难受演唱者也容易看错。但绝对音高并没有错只是记谱的位置“看不见中音区”了。我的处理方法是在转调完成后统计所有音符的八度偏移次数把出现最多的那个八度偏移拉回0也就是中音区。相当于整首曲子整体移一个八度绝对音高不变但谱面回归舒适区。from collections import Counter def normalize_octave(notes): if not notes: return notes octave_counts Counter(n[1] for n in notes) most_common octave_counts.most_common(1)[0][0] delta -most_common if delta 0: return notes return [(n[0], n[1] delta, n[2], n[3]) for n in notes]注意这里的“整体上下移一个八度”不是移调错误而是可读性校正。真正的音高已经通过新调号表达清楚了八度标记只负责告诉演奏者该往哪个区域找。4.3 稳定模式只改调号不改数字的转调前面说过人声翻唱最常见的需求其实是“只改调号”。这个需求用一个极简函数就能实现def transpose_score_stable(text, old_key, new_key): 只替换调号行数字和谱面完全不动 return re.sub(r1\s*\s*[A-G][#b]?, lambda m: f1{new_key}, text)比如把“1C”替换成“1E”后面的音符数字全部保留。这种方式看似简单但它是真实场景里最高频的需求。我建议脚本默认走“重新映射数字”模式同时提供--stable参数切到这种稳定模式。两种模式互补同一个谱子可以随时切换。5. 完整示例与自检C调谱转D调谱全流程演示5.1 完整脚本把所有函数拼起来就是一个可以直接运行的完整脚本。下面这份代码我实际放在命令行里用过麻雀虽小五脏俱全。import re import argparse from collections import Counter SCALE_SEMITONES {1: 0, 2: 2, 3: 4, 4: 5, 5: 7, 6: 9, 7: 11} KEY_SEMITONES { C: 0, C#: 1, Db: 1, D: 2, D#: 3, Eb: 3, E: 4, F: 5, F#: 6, Gb: 6, G: 7, G#: 8, Ab: 8, A: 9, A#: 10, Bb: 10, B: 11, Cb: 11, } NOTE_RE re.compile(r(?!\S)[#b]?[1-7][\,]?\.?(?!\S)) KEY_RE re.compile(r1\s*\s*[A-G][#b]?) MIDDLE_C_OCTAVE 60 def normalize_key(key_name): if len(key_name) 2 and key_name[0] in #b: return key_name[1] key_name[0] return key_name def parse_note(token): m re.fullmatch(r([#b]?)([1-7])([\,]?)(\.?), token) accident, degree_char, octave_mark, dot m.groups() degree int(degree_char) accidental {#: 1, b: -1}.get(accident, 0) octave_shift 1 if octave_mark else (-1 if octave_mark , else 0) return degree, octave_shift, accidental, dot def format_note(degree, octave_shift, accidental, dot): acc_char {1: #, -1: b, 0: }[accidental] octave_char {1: , -1: ,, 0: }[octave_shift] return f{acc_char}{degree}{octave_char}{dot} def note_to_midi(degree, octave_shift, accidental, key_semi): root key_semi MIDDLE_C_OCTAVE return root SCALE_SEMITONES[degree] accidental octave_shift * 12 def midi_to_note(midi, key_semi, key_name): diff midi - (key_semi MIDDLE_C_OCTAVE) octave_shift diff // 12 semi diff % 12 best_degree 1 best_diff 99 for degree, semitone in SCALE_SEMITONES.items(): d (semi - semitone 6) % 12 - 6 if abs(d) abs(best_diff): best_diff d best_degree degree elif abs(d) abs(best_diff): if # in key_name and d 0: best_degree degree best_diff d elif b in key_name and d 0: best_degree degree best_diff d return best_degree, octave_shift, best_diff def normalize_octave(notes): if not notes: return notes octave_counts Counter(n[1] for n in notes) most_common octave_counts.most_common(1)[0][0] delta -most_common if delta 0: return notes return [(n[0], n[1] delta, n[2], n[3]) for n in notes] def transpose_note(token, old_key, new_key): degree, oct_shift, accidental, dot parse_note(token) old_semi KEY_SEMITONES[normalize_key(old_key)] new_semi KEY_SEMITONES[normalize_key(new_key)] midi note_to_midi(degree, oct_shift, accidental, old_semi) new_degree, new_oct, new_acc midi_to_note(midi, new_semi, normalize_key(new_key)) return format_note(new_degree, new_oct, new_acc, dot) def transpose_score(text, old_key, new_key, stableFalse): if stable: return KEY_RE.sub(lambda m: f1{new_key}, text) new_key normalize_key(new_key) text KEY_RE.sub(lambda m: f1{new_key}, text) notes [] positions [] def collect(match): positions.append(match.start()) notes.append(parse_note(match.group(0))) return match.group(0) NOTE_RE.sub(collect, text) new_notes [] for degree, oct_shift, accidental, dot in notes: old_semi KEY_SEMITONES[normalize_key(old_key)] new_semi KEY_SEMITONES[normalize_key(new_key)] midi note_to_midi(degree, oct_shift, accidental, old_semi) new_deg, new_oct, new_acc midi_to_note(midi, new_semi, new_key) new_notes.append((new_deg, new_oct, new_acc, dot)) new_notes normalize_octave(new_notes) tokens list(NOTE_RE.finditer(text)) result [] last 0 for i, token_match in enumerate(tokens): result.append(text[last:token_match.start()]) degree, oct_shift, accidental, dot new_notes[i] result.append(format_note(degree, oct_shift, accidental, dot)) last token_match.end() result.append(text[last:]) return .join(result) if __name__ __main__: parser argparse.ArgumentParser(description简谱转调工具) parser.add_argument(--from, destold_key, requiredTrue, help原调例如C) parser.add_argument(--to, destnew_key, requiredTrue, help新调例如D) parser.add_argument(--stable, actionstore_true, help稳定模式只改调号不改数字) parser.add_argument(input, help输入文件路径) args parser.parse_args() with open(args.input, encodingutf-8) as f: content f.read() print(transpose_score(content, args.old_key, args.new_key, args.stable))这版代码我尽量只保留核心逻辑没有引入第三方依赖。transpose_score里先收集所有音符句柄转调后再按原位置拼回去这样谱面里的小节线、延音线、休止符都能原样保留。5.2 输入输出与人工核对用文章开头那段C调曲子做示例假设输入文件内容如下1C 4/4 1 2 3 5 | 6 5 3 1 | 5 3 2 - | 1 - - 0 |运行下面的命令python transpose_simple.py --from C --to D input.txt输出结果是1D 4/4 1 2 3 4 | 5 4 3 1 | 4 3 2 - | 1 - - 0 |我人工核对一遍C调的5G在D调里是4C调的6A在D调里是5其余1、2、3原样映射到1、2、3因为C和D的音名序列里C、D、E三个音相对位置相同。结果完全符合预期。这个例子很能说明问题数字不是“加2”而是按音高重新找位置。5.3 往返测试D调转回C调必须还原验证转调算法正确性最稳的做法是往返测试。把上面输出的D调谱子再转回C调如果算法没问题得到的应该和原始谱完全一致。我在实际验证时写过一个简单的断言original 1C 4/4\n1 2 3 5 | 6 5 3 1 | 5 3 2 - | 1 - - 0 | d_major transpose_score(original, C, D) back_to_c transpose_score(d_major, D, C) assert back_to_c original, back_to_c print(往返测试通过)这条断言我建议所有读者都跑一下。它比人工查谱快得多而且能揪出升降号策略和八度归一化里的隐藏问题。当时我在写八度修正逻辑时就是靠这条断言发现了一个往返不一致的bug。6. 批量转调扩展与实战中的几个坑6.1 给脚本加命令行入口和批量文件处理脚本跑通单首曲子以后批量处理就是顺手的事。我平时会把一个文件夹里的几十份文本谱统一转调文件多的时候手改不现实。批量逻辑很简单遍历目录分别调用transpose_score写输出文件就行。from pathlib import Path def batch_transpose(input_dir, output_dir, old_key, new_key): input_path Path(input_dir) output_path Path(output_dir) output_path.mkdir(parentsTrue, exist_okTrue) for file_path in input_path.glob(*.txt): content file_path.read_text(encodingutf-8) result transpose_score(content, old_key, new_key) out_file output_path / file_path.name out_file.write_text(result, encodingutf-8)批量处理前最好先跑一遍单文件确认输出效果符合预期再全量执行。毕竟每位用户对升降号写法的偏好可能不一样工具能做的是给出一个通用合理的结果审美差异还得靠人微调。6.2 踩过的三个坑第一个坑是正则误匹配拍号。我最初写正则时没加边界限制结果把“4/4”里的4也当音符替换了输入没转调先乱套。加上(?!\S)和(?!\S)之后拍号里的数字因为旁边有斜杠不会被匹配。但如果输入写成“4 / 4”斜杠两边有空格程序还是会误伤。所以规范里专门写了拍号必须连写。第二个坑是高低音点与附点的顺序。简谱里高音点写在数字上方附点写在数字右侧纯文本化以后容易写成“5.”或“5.”解析正则如果只固定一种顺序就会丢附点。我最后统一规定先高低音点再附点并在parse_note里做了单独分组把附点当成独立字段带回避免转调后丢附点。第三个坑是调号写法。有人写“降B调”会习惯记成“bB”程序一看就懵因为映射表里只有“Bb”。加一个normalize_key后问题迎刃而解。这种小兼容问题不处理用户第一次跑就会跑来问“为什么报错”。6.3 实际使用心得我现在拿到一份文本简谱第一件事就是跑一遍脚本看两种模式各自的输出再决定用哪个。帮歌手挪调几乎都用稳定模式改一行调号就行做乐器分谱才用重新映射数字的模式。说到底这个工具本质是“基于音高映射的文本替换”但把音乐理论里的首调逻辑和MIDI编号衔接起来之后写起来意外顺手。往后如果你想扩展还可以加入小调音阶映射、带和弦标记的简谱转调、甚至输出到MIDI文件。从这个小工具出发能延伸的方向比想象中多。
前阵子一个朋友给我一份简谱1C4/4拍排练时想让主唱试试F调问我能不能把整张谱子转一下。打印出来看了一眼虽说只有两页但真手写转调的话每个音都要单独换算碰上高低音点和临时升降号更是算得头皮发麻。正好谱子在我电脑里是纯文本形式我就想干脆写个Python小脚本把简谱转调这件事自动化。这就是这篇博文的由来用Python程序实现简谱转调把“数字谱面”从旧调整体搬到新调。说白了简谱里的1、2、3并不是固定音高而是调内的音级转调的本质是先把每个音换算成绝对音高再搬进新调的记谱体系。这篇文章会从音乐理论、输入格式设计、核心算法、记谱规范化到完整验证走一遍最后附上可以直接拿去用的脚本。适合有一定Python基础、偶尔要和简谱打交道的人——无论是做歌谱整理、乐器分谱还是帮人声翻唱换调都能用得上。1. 简谱转调为什么不能直接“数字加几”先搞清楚首调与绝对音高1.1 简谱数字是调内音级不是固定音高简谱是典型的首调记谱法。1C意思是把C音唱成do1G就是把G音唱成do。同一串“1 2 3 5”在不同调里对应的绝对音高完全不同。举个例子C调下的“1 2 3 5”分别是C、D、E、G而G调下的“1 2 3 5”是G、A、B、D。数字没变实际音高整体高了一截。这个特点对写代码的人来说是个关键认知程序如果要转调不能把“1”当成一个固定值去处理必须先知道这个“1”代表哪个调的主音。我最早试图写转调程序时踩过这个坑以为简谱转调就是把每个数字做加减法后来发现完全不是这么回事。不同调下简谱数字与音名的对应大致如下表简谱数字1C时1D时1G时1CDG2DEA3EF#B4FGC5GAD6ABE7BC#F#可以看到同一个数字“4”在C调是F在D调是G在G调是C。如果把“数字几”当成算法核心这个映射关系根本处理不了。1.2 两种转调需求改调号不动数字还是重新映射数字实际生活中“转调”其实有两种常见需求一开始要分清楚。第一种整体换调号但数字不变。这种场景最常见于人声翻唱一首歌原调1E主唱音域唱不上去想降到1D但旋律线条、唱名关系都不变只是绝对音高整体降低两个半音。这时最省事的做法是把谱子开头的“1E”改成“1D”音符数字原样保留。也就是“只改调号数字不动”。第二种重新映射数字。这种常见于器乐改编或需要把谱子翻译成另一种记谱习惯的场景。绝对音高序列保持原样但要在新调里给每个音重新找数字。比如C调旋律里的G音到了D调里就要写成4因为D调里4是G音。两种需求都值得程序支持。本文的核心算法默认做第二种“重新映射数字”因为它的技术含量更高处理好了以后第一种需求只需要顺手把调号替换一下就能实现。后面我会单独讲“稳定模式”。1.3 一个手工换算例子C调4转到D调为什么是#3先手工推一个例子感受一下“重新映射数字”到底在算什么。C调里的“4”是F音。现在要把它写进D调。D调的音级音名是D、E、F#、G、A、B、C#对应数字1到7。F这个音比D调的3E高一个半音比D调的4F#低一个半音。也就是说它在D调里既接近3又接近4实际写成“#3”或“b4”都说得过去。你看光靠“数字2”是绝对推不出“#3”或者“b4”的。这就是为什么程序不能只对数字做加减而要把每个音符先还原成绝对音高再在新调体系里重新匹配音级。理解了这一点后面的算法设计就顺理成章了。2. 输入格式设计把简谱文本变成可计算的音符事件2.1 事件模型音级、八度偏移、变音符号程序要处理的最小颗粒是“音符事件”。我把一个音符事件定义成一个简单的四元组音级数字1到7、八度偏移0表示中音1表示高音点-1表示低音点、变音符号-1降、0自然、1升。为什么要把音符拆得这么细因为简谱文本里除了音符还有大量跟音高无关的内容——小节线、拍号、延音线、休止符、附点。这些内容在转调时都应该原样保留唯一需要变化的只有音高信息。事件模型拆细以后程序就专注于替换“音符token”其他字符一概不动。比如“| 1 2 3 5 |”这行文本小节线“|”和空格原样保留“1 2 3 5”这四个数字分别构成四个音符事件转调算法只需要调整这四个事件。2.2 文本规范空格分隔的token高低音点与升降号怎么写为了让程序解析简单可靠我建议输入谱采用一种很宽松的文本规范但不是没有规矩。基本格式是这样的1C 4/4 1 2 3 5 | 6 5 3 1 | 5 3 2 - | 1 - - 0 |几个约定音符与音符之间用空格分隔不要连写。比如“56”想表达两个八分音符请写成“5 6”。这是为了让正则能稳定识别独立音符token。高音点用数字后面的撇号表示比如“5”是高音5低音点用数字后面的逗号表示比如“3,”是低音3。升降号写在数字前面#4表示升4b7表示降7。拍号请连写比如“4/4”中间不要有空格这样正则不会把拍号里的数字当成音符。休止符0、延音线-、附点.、小节线|原样保留。这个规范不算苛刻大部分从打谱软件导出的文本简谱稍作整理就能满足。附点这类符号我让音符token允许后面带一个点解析时先把点拆出来转调之后再原样拼回去。2.3 解析与回写parse_note 和 format_note有了文本规范解析就很简单。核心函数就两个一个把token拆开一个把音符事件拼回token。import re # 音符token可选升降号 数字1-7 可选高低音点 可选附点 NOTE_RE re.compile(r(?!\S)[#b]?[1-7][\,]?\.?(?!\S)) def parse_note(token): 把 b3, 这样的token解析成 (degree, oct_shift, accidental) m re.fullmatch(r([#b]?)([1-7])([\,]?)(\.?), token) if not m: raise ValueError(f无法解析音符token: {token}) accident, degree_char, octave_mark, dot m.groups() degree int(degree_char) accidental {#: 1, b: -1}.get(accident, 0) octave_shift 0 if octave_mark : octave_shift 1 elif octave_mark ,: octave_shift -1 return degree, octave_shift, accidental, dot def format_note(degree, octave_shift, accidental, dot): 把音符事件重新拼成token acc_char {1: #, -1: b, 0: }[accidental] octave_char {1: , -1: ,, 0: }[octave_shift] return f{acc_char}{degree}{octave_char}{dot}注意正则里的边界控制(?!\S)和(?!\S)这能避免把“4/4”里的4误判成音符token。这个细节特别重要后面我会专门讲。3. 核心算法实现绝对音高平移与新调音级的反向查找3.1 为什么用MIDI编号做中间表示音符已经解析成“音级、八度偏移、变音符号”了接下来要找一个中间表示让“平移”变得简单。我选的是MIDI编号。MIDI编号把每个半音映射成一个连续整数中央C是60相邻半音差1。这样转调就变成了一次纯粹的加法新MIDI 旧MIDI 偏移量。偏移量就是新旧调主音之间的半音差。为什么不用音名做中间表示因为音名有等音问题比如F和E#是同一个音高程序处理起来容易绕晕。MIDI编号没有这个问题同一个音高只有一个编号干净利落。先定义两个基础映射表# 自然大调各音级相对主音的半音数 SCALE_SEMITONES {1: 0, 2: 2, 3: 4, 4: 5, 5: 7, 6: 9, 7: 11} # 调名 - 主音半音数以C为0 KEY_SEMITONES { C: 0, C#: 1, Db: 1, D: 2, D#: 3, Eb: 3, E: 4, F: 5, F#: 6, Gb: 6, G: 7, G#: 8, Ab: 8, A: 9, A#: 10, Bb: 10, B: 11, Cb: 11, } def normalize_key(key_name): 兼容 bB、#F 这类写法统一转成 Bb、F# 风格 if len(key_name) 2 and key_name[0] in #b: return key_name[1] key_name[0] return key_name自然大调音阶里1到2是全音2到3是全音3到4是半音4到5是全音5到6是全音6到7是全音7到1是半音。这些数值就是上面SCALE_SEMITONES的来源。以后如果想支持小调或五声音阶只要换这张表就行。3.2 note_to_midi 与 midi_to_note音符到MIDI编号的计算可以这样理解先确定调主音在中央C八度里的MIDI基准再叠加上音级半音偏移、八度偏移和变音符号。MIDDLE_C_OCTAVE 60 # 中央C的MIDI编号 def note_to_midi(degree, octave_shift, accidental, key_semi): 音符事件转MIDI编号 root key_semi MIDDLE_C_OCTAVE return root SCALE_SEMITONES[degree] accidental octave_shift * 12这里的关键是“root”的算法。比如1DD的主音半音是2root就是62正好是D4的MIDI编号“1”在这个调里就是D4完全正确。反向查找是算法的核心。拿到MIDI编号后先算出它相对于新调主音的偏移然后在新调音阶里找到最接近的自然音级。这里有一个“最接近”的细节我会在下一章单独讲先看基础实现def midi_to_note(midi, key_semi): MIDI编号转回音符事件 diff midi - (key_semi MIDDLE_C_OCTAVE) octave_shift diff // 12 semi diff % 12 best_degree 1 best_diff 99 for degree, semitone in SCALE_SEMITONES.items(): d (semi - semitone 6) % 12 - 6 if abs(d) abs(best_diff): best_diff d best_degree degree accidental best_diff return best_degree, octave_shift, accidental比如C调的5G4MIDI 67转到D调新调主音半音是2root62diff5semi5自然音级里第4级是5所以得到4自动升号0。输出就是“4”。这个结果和实际情况完全一致。3.3 负数八度的正确性Python取模和整除的配合转调中最容易出错的是低音区。C调的低音6A3MIDI 57转到D调diff 57 - 62 -5。这里我用的是Python的//和%octave_shift -5 // 12 -1semi -5 % 12 7。也就是说这个音在新调里是低音区的5A3。手动推理一下D调的低音5正好是A3正确。如果换成C语言那套“整数除法截断取整”的思路-5 // 12会变成0音级直接算错。所以选Python做这类工具很省心取模和整除对负数天然是配套的。这个细节值得记一下别在转调后看到低音点才发现出了问题。4. 转调结果规范化升降号取舍与八度稳定性4.1 等音选择同一个音高在新调里到底记升号还是降号上一章的反向查找有一个隐患当半音偏移落在两个自然音级正中间时同一个音高可能有两种写法。比如C调的4F转到D调MIDI算下来会让音级选择在3和4之间摇摆既可能写成#3也可能写成b4。发声完全一样但记谱习惯不同。我的做法是做一个简单的倾向性策略如果目标调是升号调比如G、D、A、E、B、F#就优先选升号写法如果目标调是降号调比如F、Bb、Eb、Ab就优先选降号写法C调本身默认走降号写法。这个偏好和五度圈直觉一致。def choose_degree_with_tendency(semi, key_name): 根据目标调的调号倾向决定等音写法 best_degree 1 best_diff 99 for degree, semitone in SCALE_SEMITONES.items(): d (semi - semitone 6) % 12 - 6 if abs(d) abs(best_diff): best_diff d best_degree degree elif abs(d) abs(best_diff): # 平局时根据调号方向选择 if # in key_name and d 0: best_degree degree best_diff d elif b in key_name and d 0: best_degree degree best_diff d return best_degree, best_diff实际效果是什么比如D调是升号调碰到F音这种可能写成#3的程序会倾向升号如果是Bb调碰到类似位置会倾向降号写法。这样输出的谱面更符合读谱习惯。当然如果你只是想要绝对音高正确不讲究记谱风格这个策略可以完全省略。4.2 整行八度整体修正转调后谱面别全往低音区跑还有一个很实际的问题转调后音符的八度分布可能会大幅偏移。比如一首1E的谱子整体降到1C很多音符会落到低音区满屏都是逗号看着难受演唱者也容易看错。但绝对音高并没有错只是记谱的位置“看不见中音区”了。我的处理方法是在转调完成后统计所有音符的八度偏移次数把出现最多的那个八度偏移拉回0也就是中音区。相当于整首曲子整体移一个八度绝对音高不变但谱面回归舒适区。from collections import Counter def normalize_octave(notes): if not notes: return notes octave_counts Counter(n[1] for n in notes) most_common octave_counts.most_common(1)[0][0] delta -most_common if delta 0: return notes return [(n[0], n[1] delta, n[2], n[3]) for n in notes]注意这里的“整体上下移一个八度”不是移调错误而是可读性校正。真正的音高已经通过新调号表达清楚了八度标记只负责告诉演奏者该往哪个区域找。4.3 稳定模式只改调号不改数字的转调前面说过人声翻唱最常见的需求其实是“只改调号”。这个需求用一个极简函数就能实现def transpose_score_stable(text, old_key, new_key): 只替换调号行数字和谱面完全不动 return re.sub(r1\s*\s*[A-G][#b]?, lambda m: f1{new_key}, text)比如把“1C”替换成“1E”后面的音符数字全部保留。这种方式看似简单但它是真实场景里最高频的需求。我建议脚本默认走“重新映射数字”模式同时提供--stable参数切到这种稳定模式。两种模式互补同一个谱子可以随时切换。5. 完整示例与自检C调谱转D调谱全流程演示5.1 完整脚本把所有函数拼起来就是一个可以直接运行的完整脚本。下面这份代码我实际放在命令行里用过麻雀虽小五脏俱全。import re import argparse from collections import Counter SCALE_SEMITONES {1: 0, 2: 2, 3: 4, 4: 5, 5: 7, 6: 9, 7: 11} KEY_SEMITONES { C: 0, C#: 1, Db: 1, D: 2, D#: 3, Eb: 3, E: 4, F: 5, F#: 6, Gb: 6, G: 7, G#: 8, Ab: 8, A: 9, A#: 10, Bb: 10, B: 11, Cb: 11, } NOTE_RE re.compile(r(?!\S)[#b]?[1-7][\,]?\.?(?!\S)) KEY_RE re.compile(r1\s*\s*[A-G][#b]?) MIDDLE_C_OCTAVE 60 def normalize_key(key_name): if len(key_name) 2 and key_name[0] in #b: return key_name[1] key_name[0] return key_name def parse_note(token): m re.fullmatch(r([#b]?)([1-7])([\,]?)(\.?), token) accident, degree_char, octave_mark, dot m.groups() degree int(degree_char) accidental {#: 1, b: -1}.get(accident, 0) octave_shift 1 if octave_mark else (-1 if octave_mark , else 0) return degree, octave_shift, accidental, dot def format_note(degree, octave_shift, accidental, dot): acc_char {1: #, -1: b, 0: }[accidental] octave_char {1: , -1: ,, 0: }[octave_shift] return f{acc_char}{degree}{octave_char}{dot} def note_to_midi(degree, octave_shift, accidental, key_semi): root key_semi MIDDLE_C_OCTAVE return root SCALE_SEMITONES[degree] accidental octave_shift * 12 def midi_to_note(midi, key_semi, key_name): diff midi - (key_semi MIDDLE_C_OCTAVE) octave_shift diff // 12 semi diff % 12 best_degree 1 best_diff 99 for degree, semitone in SCALE_SEMITONES.items(): d (semi - semitone 6) % 12 - 6 if abs(d) abs(best_diff): best_diff d best_degree degree elif abs(d) abs(best_diff): if # in key_name and d 0: best_degree degree best_diff d elif b in key_name and d 0: best_degree degree best_diff d return best_degree, octave_shift, best_diff def normalize_octave(notes): if not notes: return notes octave_counts Counter(n[1] for n in notes) most_common octave_counts.most_common(1)[0][0] delta -most_common if delta 0: return notes return [(n[0], n[1] delta, n[2], n[3]) for n in notes] def transpose_note(token, old_key, new_key): degree, oct_shift, accidental, dot parse_note(token) old_semi KEY_SEMITONES[normalize_key(old_key)] new_semi KEY_SEMITONES[normalize_key(new_key)] midi note_to_midi(degree, oct_shift, accidental, old_semi) new_degree, new_oct, new_acc midi_to_note(midi, new_semi, normalize_key(new_key)) return format_note(new_degree, new_oct, new_acc, dot) def transpose_score(text, old_key, new_key, stableFalse): if stable: return KEY_RE.sub(lambda m: f1{new_key}, text) new_key normalize_key(new_key) text KEY_RE.sub(lambda m: f1{new_key}, text) notes [] positions [] def collect(match): positions.append(match.start()) notes.append(parse_note(match.group(0))) return match.group(0) NOTE_RE.sub(collect, text) new_notes [] for degree, oct_shift, accidental, dot in notes: old_semi KEY_SEMITONES[normalize_key(old_key)] new_semi KEY_SEMITONES[normalize_key(new_key)] midi note_to_midi(degree, oct_shift, accidental, old_semi) new_deg, new_oct, new_acc midi_to_note(midi, new_semi, new_key) new_notes.append((new_deg, new_oct, new_acc, dot)) new_notes normalize_octave(new_notes) tokens list(NOTE_RE.finditer(text)) result [] last 0 for i, token_match in enumerate(tokens): result.append(text[last:token_match.start()]) degree, oct_shift, accidental, dot new_notes[i] result.append(format_note(degree, oct_shift, accidental, dot)) last token_match.end() result.append(text[last:]) return .join(result) if __name__ __main__: parser argparse.ArgumentParser(description简谱转调工具) parser.add_argument(--from, destold_key, requiredTrue, help原调例如C) parser.add_argument(--to, destnew_key, requiredTrue, help新调例如D) parser.add_argument(--stable, actionstore_true, help稳定模式只改调号不改数字) parser.add_argument(input, help输入文件路径) args parser.parse_args() with open(args.input, encodingutf-8) as f: content f.read() print(transpose_score(content, args.old_key, args.new_key, args.stable))这版代码我尽量只保留核心逻辑没有引入第三方依赖。transpose_score里先收集所有音符句柄转调后再按原位置拼回去这样谱面里的小节线、延音线、休止符都能原样保留。5.2 输入输出与人工核对用文章开头那段C调曲子做示例假设输入文件内容如下1C 4/4 1 2 3 5 | 6 5 3 1 | 5 3 2 - | 1 - - 0 |运行下面的命令python transpose_simple.py --from C --to D input.txt输出结果是1D 4/4 1 2 3 4 | 5 4 3 1 | 4 3 2 - | 1 - - 0 |我人工核对一遍C调的5G在D调里是4C调的6A在D调里是5其余1、2、3原样映射到1、2、3因为C和D的音名序列里C、D、E三个音相对位置相同。结果完全符合预期。这个例子很能说明问题数字不是“加2”而是按音高重新找位置。5.3 往返测试D调转回C调必须还原验证转调算法正确性最稳的做法是往返测试。把上面输出的D调谱子再转回C调如果算法没问题得到的应该和原始谱完全一致。我在实际验证时写过一个简单的断言original 1C 4/4\n1 2 3 5 | 6 5 3 1 | 5 3 2 - | 1 - - 0 | d_major transpose_score(original, C, D) back_to_c transpose_score(d_major, D, C) assert back_to_c original, back_to_c print(往返测试通过)这条断言我建议所有读者都跑一下。它比人工查谱快得多而且能揪出升降号策略和八度归一化里的隐藏问题。当时我在写八度修正逻辑时就是靠这条断言发现了一个往返不一致的bug。6. 批量转调扩展与实战中的几个坑6.1 给脚本加命令行入口和批量文件处理脚本跑通单首曲子以后批量处理就是顺手的事。我平时会把一个文件夹里的几十份文本谱统一转调文件多的时候手改不现实。批量逻辑很简单遍历目录分别调用transpose_score写输出文件就行。from pathlib import Path def batch_transpose(input_dir, output_dir, old_key, new_key): input_path Path(input_dir) output_path Path(output_dir) output_path.mkdir(parentsTrue, exist_okTrue) for file_path in input_path.glob(*.txt): content file_path.read_text(encodingutf-8) result transpose_score(content, old_key, new_key) out_file output_path / file_path.name out_file.write_text(result, encodingutf-8)批量处理前最好先跑一遍单文件确认输出效果符合预期再全量执行。毕竟每位用户对升降号写法的偏好可能不一样工具能做的是给出一个通用合理的结果审美差异还得靠人微调。6.2 踩过的三个坑第一个坑是正则误匹配拍号。我最初写正则时没加边界限制结果把“4/4”里的4也当音符替换了输入没转调先乱套。加上(?!\S)和(?!\S)之后拍号里的数字因为旁边有斜杠不会被匹配。但如果输入写成“4 / 4”斜杠两边有空格程序还是会误伤。所以规范里专门写了拍号必须连写。第二个坑是高低音点与附点的顺序。简谱里高音点写在数字上方附点写在数字右侧纯文本化以后容易写成“5.”或“5.”解析正则如果只固定一种顺序就会丢附点。我最后统一规定先高低音点再附点并在parse_note里做了单独分组把附点当成独立字段带回避免转调后丢附点。第三个坑是调号写法。有人写“降B调”会习惯记成“bB”程序一看就懵因为映射表里只有“Bb”。加一个normalize_key后问题迎刃而解。这种小兼容问题不处理用户第一次跑就会跑来问“为什么报错”。6.3 实际使用心得我现在拿到一份文本简谱第一件事就是跑一遍脚本看两种模式各自的输出再决定用哪个。帮歌手挪调几乎都用稳定模式改一行调号就行做乐器分谱才用重新映射数字的模式。说到底这个工具本质是“基于音高映射的文本替换”但把音乐理论里的首调逻辑和MIDI编号衔接起来之后写起来意外顺手。往后如果你想扩展还可以加入小调音阶映射、带和弦标记的简谱转调、甚至输出到MIDI文件。从这个小工具出发能延伸的方向比想象中多。
