使用 music21 的 transpose() 方法时，传入 -P8（而非 -12）可实现纯八度向下移调，避免因半音数计算导致的等音替换（如 D♭→C♯），确保调性符号（升降号）逻辑一致。
使用 music21 的 `transpose()` 方法时，传入 `-p8`（而非 `-12`）可实现纯八度向下移调，避免因半音数计算导致的等音替换（如 d♭→c♯），确保调性符号（升降号）逻辑一致。
在音乐编程中，精确的音高转调不仅关乎音高数值变化，更涉及乐谱语义的正确表达。music21 提供了两种转调方式：基于半音数的整数偏移（如 -12）和基于音程名称的符号化偏移（如 '-P8'）。前者仅改变 MIDI 音高值，不考虑调性上下文，因此 Pitch('D-4').transpose(-12) 会得到 C#3——虽然音高等效，但记谱上由降号变为升号，违背了调性一致性原则。
而 '-P8' 表示“纯八度下行”（Perfect Octave down），music21 会依据原始音名与变音记号，智能推导目标音高并保留等效记谱逻辑。例如：
import music21
p = music21.pitch.Pitch('D-4')
print(p.transpose('-P8')) # 输出: D-3
print(p.transpose('-P15')) # 输出: D-2（两个八度）
✅ 正确做法：始终对八度类转调使用 'P8'、'm3'、'M7' 等音程字符串，而非整数。
⚠️ 注意事项：
-
'-P8'中的'P'必须大写，'8'是罗马数字形式的度数； - 字符串需加引号（如
'-P8'），不可写作-P8（Python 会报错）； - 支持复合音程，如
'-P15'（双八度）、'+M9'（九度上行）等，均保持调性感知； - 若需批量处理
Note或Chord对象，同样适用.transpose()，内部自动委托给各Pitch实例。
总结：音乐信息处理中，“音高等效”不等于“记谱等价”。借助 music21 的符号化音程转调，既能保证声学准确性，又能维护乐谱的可读性与理论严谨性——这是专业音乐编程实践的关键细节。
