C++读MIDI文件需用二进制模式：先读4字节"MThd"签名，再读4字节大端长度，接着解析6字节头信息（格式、轨道数、PPQ），所有多字节数需手动大端转小端。
怎么用 C++ 读取 MIDI 文件头和音轨块
MIDI 文件是二进制格式，不是文本，不能用 fgets 或 std::getline 直接读。必须按规范逐字节解析：先读 4 字节的 "MThd" 签名，再读 4 字节长度（大端序），接着是 header 块的 6 字节内容（格式、轨道数、PPQ）。常见错误是直接用 char* 当字符串打印 "MThd" 后面的字节——它后面紧跟着的是长度字段，不是可读文本。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
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 个独立事件，或把时间值严重放大/缩小。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 写一个辅助函数
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”：即当前状态未变时，后续事件可省略状态字节，只跟数据字节。忽略这点会导致后续所有事件偏移、音符错乱。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 维护一个
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 的事件继续解析。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 每个 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 怎么切——这些地方没测试用例兜底，很容易在某个冷门文件上突然崩掉。
