必须使用 DryWetMIDI 库（NuGet 包名 Melanchall.DryWetMidi）生成标准 MIDI 文件，因 .NET 原生不支持；音符需作为 NoteOn/NoteOff 事件显式添加至 TrackChunk，且必须调用 MidiFile.Write() 导出。
用 MidiFile 类生成标准 MIDI 文件需要第三方库
原生 .NET 没有内置 MIDI 文件生成支持，System.IO.Ports 只管串口通信，NAudio 也只读不写 MIDI 文件。必须引入像 DryWetMIDI 这类专注 MIDI 结构的库——它把 TrackChunk、Event、Tempo 全部封装成对象，避免手动拼接二进制 header 和 delta-time。
常见错误是试图用 BinaryWriter 手写 SMF 格式：header 四字节 magic（"MThd"）、track chunk 的 "MTrk" 标签、事件时间戳编码规则……稍错一位就导致 DAW 打不开或静音。
- 推荐直接
dotnet add package Melanchall.DryWetMidi - 不要用
NAudio.Lame或ManagedBass替代——它们不处理 MIDI 文件序列化 - 注意 NuGet 包名是
Melanchall.DryWetMidi，不是DryWetMIDI（大小写敏感）
Notes 添加必须绑定到 TrackChunk 才能写入文件
在 DryWetMIDI 中，音符不是独立存在，而是作为 NoteOnEvent 和 NoteOffEvent 插入某个 TrackChunk 的事件列表。漏掉 track.Events.Add() 或误加到 MidiFile 根节点，生成的文件里就无声。
典型场景：想写一个中央 C（MIDI 音符 60）持续一拍（四分音符），需同时添加两个事件，并确保它们属于同一 track。
- 先创建
var track = new TrackChunk()，再调用track.Events.Add(new NoteOnEvent(60, 100)) -
NoteOffEvent时间点不能靠“自动配对”——必须显式设置其DeltaTime或用note.OffVelocity = 0后调用note.GetNoteOffEvent() - 所有事件的时间单位是
Tick，默认DivisionsPerQuarterNote = 480；改这个值会影响节奏精度，但别轻易动，多数 DAW 依赖默认值
var note = new Note(NoteName.C, OctaveNumber.Four); note.Length = new MusicalTimeSpan(1, 0); // 一拍 track.Events.Add(note.GetNoteOnEvent()); track.Events.Add(note.GetNoteOffEvent());
导出前必须调用 MidiFile.Write()，且路径需有写权限
很多人写完 event 就以为完事了，结果文件为空或报 IOException。DryWetMIDI 不会自动 flush 到磁盘，必须显式调用 Write() 方法。路径若指向系统保护目录（如 C:\Program Files\）或未创建父目录，也会失败，但错误信息常被吞掉，只显示“访问被拒绝”。
- 检查路径是否存在：
Directory.CreateDirectory(Path.GetDirectoryName(filePath)) - 写入时捕获
UnauthorizedAccessException和DirectoryNotFoundException - 不要用
File.Create()预创建空文件——MidiFile.Write()会覆盖，且预创建可能造成句柄占用 - 示例：
new MidiFile(track).Write("output.mid")，不是file.Save()或file.Export()
多音轨、速度变化、控制器事件容易漏设 Timing
单轨简单旋律能响，但加个渐快（SetTempoEvent）或切换音色（ProgramChangeEvent）就跑调或变音，往往是因为没指定这些事件的 DeltaTime——它们被插在开头，导致整段偏移。
真实使用中，节奏变化和表情控制都在时间轴上精确定位，不是“追加到末尾”就行。
-
SetTempoEvent必须插入在对应时间点的 track 事件流中，比如第 2 小节开始加速，就得算准前面所有 note 的 tick 总和 - 控制器事件（如弯音轮
PitchBendEvent）要设Channel，否则默认 channel 0，但很多软音源监听的是 channel 1 - 多轨混音时，各
TrackChunk的事件时间都是相对于各自起点，不是全局时间；合并前需确认是否已做AdjustTime对齐
复杂节奏和实时控制器数据，光靠手算 tick 很容易错。真要动态生成，建议封装一个 Timeline 类来管理绝对时间戳映射。
