c++读midi文件需用二进制模式:先读4字节"mthd"签名,再读4字节大端长度,接着解析6字节头信息(格式、轨道数、ppq),所有多字节数需手动大端转小端。

怎么用 C++ 读取 MIDI 文件头和音轨块
MIDI 文件是二进制格式,不是文本,不能用 fgets 或 std::getline 直接读。必须按规范逐字节解析:先读 4 字节的 "MThd" 签名,再读 4 字节长度(大端序),接着是 header 块的 6 字节内容(格式、轨道数、PPQ)。常见错误是直接用 char* 当字符串打印 "MThd" 后面的字节——它后面紧跟着的是长度字段,不是可读文本。
实操建议:
- 用
std::ifstream以std::ios::binary模式打开,read()配合reinterpret_cast<char></char>读原始字节 - 长度字段(如 header length、track chunk length)必须用大端转小端:例如
(data[0] - 跳过未知 chunk 类型时,别只读声明的长度——有些文件会在 chunk 内部嵌套子 chunk,但标准 MIDI 只要求跳过整个 chunk length 字节数即可
如何解析 MIDI 事件的时间戳(delta-time)
delta-time 是变长整数(Variable-Length Quantity, VLQ),每个字节最高位表示“是否还有后续字节”,剩下 7 位拼成数值。不按规则解析就会把一个 3 字节的 delta-time 当成 3 个独立事件,或把时间值严重放大/缩小。
实操建议:
- 写一个辅助函数
read_vlq(),循环读字节,每次取低 7 位,直到某字节最高位为 0;累计结果时注意左移位数(每轮 ×128) - VLQ 解析失败的典型现象:事件时间突变为极大值(如 0x3F800000),或解析中途卡死在某个字节(一直遇到高位为 1)
- PPQ(Pulses Per Quarter Note)决定时间单位意义——若 PPQ=96,delta-time=192 表示两个四分音符;但若文件是 SMPTE 时间码格式(format == 1 且 division & 0x8000),则 delta-time 含义完全不同,需先检查 header 的
division字段高位
怎样正确识别并提取音符事件(Note On/Off)
MIDI 事件分 channel message 和 system message,音符事件属于前者的 0x9n(Note On)和 0x8n(Note Off),其中 n 是通道号(0–15)。但实际文件中大量使用“running status”:即当前状态未变时,后续事件可省略状态字节,只跟数据字节。忽略这点会导致后续所有事件偏移、音符错乱。
实操建议:
- 维护一个
current_status变量,每次读到新状态字节(0x80–0xEF)就更新它;之后若读到非状态字节( - Note On 的 velocity 为 0 时等效于 Note Off——这是标准行为,不是 bug。不要单独过滤掉 velocity==0 的
0x9n - 注意
0x9n后必须紧跟两个数据字节(note number + velocity),顺序错或缺字节会导致后续全部解析错位;建议用assert(bytes_read == 2)在调试阶段校验
为什么解析出来的音符时间或音高明显不对
最常被忽略的是 MIDI 文件的“Track End”事件(0xFF 0x2F 0x00)之后仍有数据——有些合成器导出的文件会在末尾补零或插入私有 meta event,若没严格按 chunk 边界截断,会把下一 track 的开头误当成本 track 的事件继续解析。
实操建议:
- 每个 track chunk 解析到
0xFF 0x2F 0x00就立即终止,不要尝试“读完 chunk 声称的长度”——因为实际数据可能短于该长度(尤其压缩 MIDI 或编辑器残留) - 音高错乱往往源于没处理 key signature meta event(
0xFF 0x59)或调号变更,但这不影响 note number 解析;真正影响音高的只有note number字段本身(0–127),其他都是显示/演奏上下文 - 用现成库(如
rtmidi或libsmf)验证自己解析结果时,注意它们默认可能忽略 sysex 或部分 meta event——你的解析器若严格按 spec 实现,输出反而看起来“多”了
真正难的不是读字节,而是对每个字段的语义边界保持警惕:VLQ 怎么截、running status 怎么续、meta event 怎么跳、chunk 怎么切——这些地方没测试用例兜底,很容易在某个冷门文件上突然崩掉。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











