Java MidiSystem 怎样读取 MIDI 序列中的轨道

Java 读取 MIDI 轨道的最小路径是：用 MidiSystem.getSequence(File) 得到 Sequence，再调用 getTracks() 取得 Track 数组；对每条轨道按 size() 和 get(index) 遍历 MidiEvent。读取文件本身不需要打开播放器或合成器。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/sound/midi/MidiSystem.html

先定位序列与轨道

若已经拿到文件，却只看到一个 Sequence 对象，先确认自己需要的是结构检查还是播放。Sequence 保存轨道与计时信息，Track 保存事件集合；轨道不是一段已经解码的 PCM 音频。下面程序只读取结构，适合先排除文件与遍历问题。

再区分事件与消息

将代码保存为 MidiTracks.java。示例限制每条轨道打印前十个事件，轨道总事件数仍完整显示，避免大型文件产生过量日志。

import java.io.File;
import java.io.IOException;
import javax.sound.midi.*;

public class MidiTracks {
    public static void main(String[] args) {
        // 文件名由调用者提供，不创建或修改原MIDI文件。
        if (args.length != 1) {
            System.err.println("用法：java MidiTracks 文件.mid");
            return;
        }
        try {
            Sequence sequence = MidiSystem.getSequence(new File(args[0]));
            Track[] tracks = sequence.getTracks();
            System.out.println("轨道数：" + tracks.length);
            System.out.println("计时类型：" + sequence.getDivisionType());
            System.out.println("分辨率：" + sequence.getResolution());
            for (int t = 0; t 

# 编译示例，并读取你有权使用的标准MIDI文件。
javac MidiTracks.java
java MidiTracks sample.mid

程序未在本文环境执行，所以不提供固定轨道数或伪造输出。实际结果取决于输入文件；应看到轨道数量、计时配置和各轨道的事件摘要。

从错误现象判断问题层次

Track.size() 是事件数量，可能包含控制、元事件等内容，不能直接作为音符数量。Track 与 MIDI 通道也不是一一对应关系，一条轨道可包含多个通道的事件。需要提取音符时，应在结构读取正确后再添加消息语义处理。

读取后的核对清单

• 轨道循环使用 tracks.length，事件循环使用 track.size()，避免混用上下界。
• 打印或保存轨道索引和事件索引，便于回查原位置。
• 计时信息保留在 Sequence 层，不将 tick 擅自解释成秒。
• 只做读取时不打开 Sequencer，避免把播放设备故障混入文件解析排查。

读取成功却没有声音，是失败了吗？

不是。该示例没有播放动作，结构读取成功与音频输出是两项不同任务。

能在遍历时随意删除事件吗？

不建议在按索引读取的同一循环里直接修改集合；修改会影响后续索引。若要编辑，先明确独立的修改策略。

模块化项目需要什么？

javax.sound.midi 属于 java.desktop。使用 module-info.java 的项目需声明相应模块依赖；本文命令示例采用普通类路径方式。

参考：MidiSystem；Sequence；Track。