简体中文
Mac 上的 MIDI 键盘不工作
InputConfig 在 Mac App Store 免费提供。支持 macOS 14 或更高版本，无需账户，不追踪，开源。
在 Mac 上毫无反应的 MIDI 键盘，是在三个地方之一出了问题：Mac 看不到它，Mac 看到了而音乐 App 没有在听，或者音符已经到达而没有任何东西被设定去发声。区分它们最快的办法，是检查 Mac 到底有没有听到音符，这只要一分钟，不需要任何额外软件。
下面的 macOS 步骤来自 Apple 的 Audio MIDI Setup 指南。我做了 InputConfig，这是一款把 MIDI 琴键变成快捷键的免费 Mac App，它的 MIDI 视图是查看键盘发送内容的又一种办法。
步骤
- 在 Chrome、Edge 或 Firefox 里打开 MIDI 测试工具，点按 Start listening 并弹一个键。
- 如果什么都没显示，打开 Audio MIDI Setup，选择 Window, Show MIDI Studio，然后点按 Rescan MIDI。
- 如果键盘在那里变暗了，双击它，确认选中了 Device is online。
- 如果 Mac 听到了键盘，就在你的音乐 App 里打开它的输入，并让一个轨道进入录音待机。
- 对于蓝牙键盘，用 MIDI Studio 的 Configure Bluetooth 按钮连接它。
看看 Mac 有没有听到音符
- 你：在 Chrome、Edge 或 Firefox 里打开 MIDI 测试工具，点按 Start listening，允许 MIDI，然后弹一个键。Safari 对网页没有 MIDI 支持。
- macOS：把键盘的每条消息传给这个页面。
- 检查：图上有一个音符亮起，它的编号出现在列表里。
如果那里显示了音符，说明键盘和线缆都没问题，故障在音乐 App 里。如果什么都没显示，说明 Mac 没有看到键盘，接下来的两节就是为你准备的。
如果键盘不在 MIDI Studio 里
用聚焦搜索打开 Audio MIDI Setup，选择 Window, Show MIDI Studio。Apple 的指南说，USB 端口上的 MIDI 设备通常会被自动检测到，并显示在那里。
- 重新扫描。点按 MIDI Studio 工具栏里的 Rescan MIDI 按钮。
- 检查基本情况。Apple 的清单：确认它连接妥当，已经开机，并且已安装制造商要求的任何软件。
- 换一条路径。试试另一根线，并用 Mac 本身的端口代替集线器。
键盘不在 MIDI Studio 里，是线缆、供电或驱动的问题，任何 App 设置都解决不了。Apple 的页面是 If a connected MIDI device is not shown。
如果键盘变暗了
MIDI Studio 里变暗的设备，可能已关闭或断开。双击它，在它的 Properties 窗口里确认选中了 Device is online。如果原来没选中，就选中它并点按 Apply。如果本来就选中了，就把键盘重新连接到 Mac。
变暗表示 Mac 记得这个键盘，只是现在联系不上它。
如果 Mac 听到了而音乐 App 没听到
- GarageBand 和 Logic Pro。它们会监听每个 MIDI 源。选择一个软件乐器轨道并弹奏。
- Ableton Live。在 Settings, Link, Tempo and MIDI 里为键盘的输入打开 Track。
- 其他音乐 App。在 App 的 MIDI 设置里打开键盘的输入。
- 轨道。让它进入录音待机，或者打开监听，如果它只听一个通道，就让它的 MIDI 通道与键盘的一致。
大多数没有声音的设置，是轨道没有进入录音待机，或者输入没有打开。控制器键盘自己不发声，所以声音总是来自 App 里的乐器。
如果是蓝牙 MIDI 键盘
蓝牙 MIDI 要在 Audio MIDI Setup 里连接。在 MIDI Studio 里，点按工具栏里的 Configure Bluetooth 按钮，让键盘进入配对模式，在列表里选中它，再点按 Connect。Apple 的指南还说，要先安装键盘制造商提供的任何软件。
一直没出现在你的音乐 App 里的蓝牙 MIDI 键盘，通常是从来没有在 MIDI Studio 里连接过。Mac 上的蓝牙 MIDI有完整步骤。
运行 Apple 自己的测试
- 你：在 MIDI Studio 里，点按工具栏里的 Test MIDI Setup 按钮，然后在键盘上弹一个音符。
- macOS：音符到达时，高亮键盘图标上的向上箭头，也就是它的 In 端口。
- 检查：再点按一次 Test MIDI Setup，退出测试模式。
箭头亮起，是 Mac 自己确认键盘被听到了。Apple 的页面是 Test your MIDI connection。
让正常工作的键盘派上更多用场
Mac 一旦听到它，MIDI 键盘能做的就不止是弹奏音符。InputConfig 把每个键、打击垫、旋钮和踏板变成任何 App 里的键盘快捷键、点按、短语或 App 启动，它的 Live Visualizer 会在每个音符和旋钮到达时显示出来。同一个视图也是快速检查：如果一个键在那里亮了，Mac 就听到了它。Mac 上的 MIDI 转按键有设置方法。
简短总结
- 什么都没到达 Mac。打开 MIDI Studio 并选择 Rescan MIDI，然后检查线缆、供电和制造商的软件。
- 变暗。Device is online，然后重新连接。
- Mac 听到了。在音乐 App 里打开输入，并让一个轨道进入录音待机。
- 蓝牙。用 MIDI Studio 的 Configure Bluetooth 按钮连接。
先弄清 Mac 有没有听到音符，可能的原因就排除了一半。
常见问题
为什么我的 MIDI 键盘在 Mac 上不工作？
要么 Mac 看不到它，要么音乐 App 没有在听它。先检查 Audio MIDI Setup 里的 MIDI Studio：如果键盘缺失或变暗，就修复连接。如果它在那里，就在音乐 App 里打开它的输入，并让一个轨道进入录音待机。
如何让 Mac 识别 MIDI 键盘？
打开 Audio MIDI Setup，选择 Window, Show MIDI Studio，然后点按 Rescan MIDI。如果它仍然没有出现，就检查线缆、它是否已开机，以及制造商要求的任何软件是否已安装。
为什么我的 MIDI 键盘在 Audio MIDI Setup 里变暗了？
它可能已关闭或断开。双击它，确认选中了 Device is online，并重新连接键盘。
MIDI 键盘在 Mac 上需要驱动吗？
许多 USB 键盘不用安装任何东西就会自己出现。Apple 的指南说要安装制造商要求的任何软件，所以如果你的没有出现，请查看制造商的网站。
为什么我的 MIDI 键盘在 Mac 上没有声音？
控制器键盘发送音符，自己不发声。在 GarageBand 之类的音乐 App 里选择一个软件乐器轨道，确认键盘的输入已打开，然后弹奏。
如何在 Mac 上测试 MIDI 键盘？
在 Audio MIDI Setup 的 MIDI Studio 里，点按 Test MIDI Setup 并弹一个音符：设备上的向上箭头会亮起。或者在 Chrome、Edge 或 Firefox 里打开浏览器的 MIDI 测试工具，看音符到达。
更多中文页面
详细指南（英文）
作者说明。Ryleigh Newman 开发了 InputConfig，因为双手活动不便，每天都用手柄操作自己的 Mac。本页译自英文。Mac 的语言设为简体中文时，App 的主要按钮和菜单显示为中文，本页使用这些名称，并在括号中附上英文名称。App 的其他部分和网站的其他页面都是英文。
本页的其他语言版本： English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, Français, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文
免费。macOS 14 或更高版本。无需账户，数据不会离开你的 Mac。 源代码在 GitHub 上.