如何调用Pygame.midi并修改、新增其MIDI乐器配置？

底层依赖与乐器列表来源 #

• 明确结论：Pygame.midi 是完全基于PortMidi库封装开发的，所有MIDI指令的收发、跨平台适配逻辑都直接调用PortMidi的接口实现，没有独立自研的MIDI通信层。
• 不存在Pygame内置的专属MIDI乐器列表：你之前接触到的127种可选乐器，本质是通用MIDI（GM）规范定义的Program Change指令合法取值范围（编号0到126，刚好127个）。Pygame模块本身没有硬编码存储任何乐器名称、音色映射的固定表单，不会自带乐器选择列表。
• 所有对应乐器名称和编号的对照表，都是基于通用MIDI规范整理的公开标准内容，不需要Pygame单独提供专属的乐器列表。

Pygame.midi 常规调用方法 #

整个模块的逻辑就是纯粹的MIDI指令透传，核心常用操作没有复杂封装：

• 初始化：启动MIDI功能前必须执行 pygame.midi.init() 加载底层PortMidi资源，程序退出前要执行 pygame.midi.quit() 释放被占用的MIDI端口，避免端口锁死。
• 找输出端口：调用 pygame.midi.get_default_output_id() 获取系统默认MIDI输出设备的索引，再用 pygame.midi.Output(device_id) 实例化输出对象，后续所有音符、控制指令都通过这个对象发送。
• 切换乐器：调用输出对象的 set_instrument(program_no, channel=0) 方法，发送Program Change指令切换对应MIDI通道的音色，参数program_no取0-126范围内的标准GM音色编号即可。
• 控制音符：通过 note_on(note_pitch, velocity, channel=0) 方法触发指定音高、演奏力度的音符，演奏结束前必须调用 note_off(note_pitch, velocity, channel=0) 关闭对应通道的音符，避免出现持续延音的问题。
• 查看设备列表：遍历从0到设备总数-1的索引，调用 get_device_info(index) 可以获取每个设备的名称、输入/输出属性、是否被占用等基础信息，方便手动指定非默认的MIDI设备。

自定义/修改乐器的实现逻辑 #

Pygame.midi本身没有提供修改内置乐器列表、加载自定义音色的接口，这是由它的纯透传定位决定的——它不参与任何音色合成、采样存储的过程，所有实际播放的声音都是链路末端的MIDI输出设备生成的。实际实现自定义乐器需求的可行方案：

• 调整输出端的音源配置：这是最稳妥的实现方式。对接支持自定义音色加载的本地软合成器，把你自己准备的自定义乐器采样映射到指定的MIDI Program编号上。之后Pygame只要发送对应编号的切换指令，输出端就会播放你自定义的音色，整个过程不需要修改Pygame模块的任何代码。
• 代码层做自定义映射封装：如果不想依赖通用GM的音色编号规则，完全可以在自己的项目里维护一套独立的自定义乐器ID体系。比如把项目里用到的“定制钢琴”“民俗吹管”这类非标准音色定义成自己的ID，代码里加一层映射逻辑，把自定义ID转换成对应软音源上已经配置好的Program编号，实际发送指令时做一次转换就行，完全不影响Pygame的正常运行。
• 常见误区提醒：很多入门教程里贴的127个乐器名称对照表，是教程作者基于通用MIDI规范整理的演示常量，不是Pygame模块内置的内容，根本不存在“修改Pygame源码里的乐器列表”这种操作空间。

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