music21的getElementsByClass获取stream.Voice无输出报错如何解决

问题原因 #

music21自v7.0版本开始调整了MIDI文件的默认解析逻辑：旧版本会自动将同一声部轨道内的多声部内容识别为stream.Voice对象并生成对应层级；新版本仅在MIDI文件包含明确的Voice元标识时才会生成stream.Voice对象，否则会直接将音符挂载到Measure或Part层级下，这就是你调用getElementsByClass(stream.Voice)返回空列表的核心原因。

调试定位步骤 #

• 首先确认当前安装的music21版本，执行代码：
  import music21; print(music21.__version__)
  如果输出版本号≥7.0.0，即可确定为版本变更导致的兼容问题
• 打印melody_stream的完整结构，确认层级关系：
  melody_stream.show('text')
  可以直接查看流内所有子元素的类型与层级，确认是否存在stream.Voice对象
• 遍历输出流内所有元素的类型，验证音符挂载位置：
  for elem in melody_stream.flat: print(type(elem))
  确认音符是直接挂载在Measure下，还是被Voice对象包裹

修复方案 #

方案1：匹配课程环境 #

直接降级music21到v6.x的最终稳定版本即可完全兼容旧代码：
pip install music21==6.7.1

方案2：适配新版本逻辑 #

如果需要使用新版本的功能，可主动触发Voice生成逻辑后再提取：

# 主动生成Voice对象
melody_stream.makeVoices()
# 再执行原有提取逻辑
melody1, melody2 = melody_stream.getElementsByClass(stream.Voice)

内容的提问来源于stack exchange，提问作者maamli