简体中文

为什么你的 Anki 手柄在 Mac 上检测不到或不起作用

在 Mac App Store 下载 InputConfig这款应用完全免费。无需创建账户。没有订阅，没有麻烦的下载，也没有任何锁定的功能。针对 Apple 芯片优化。

几乎每次的原因，要么是遥控器处在错误的模式，要么是 Mac 上没有任何东西把它的按钮变成 Anki 的按键。Mac 上的 Anki 自己不读取手柄。它需要 Contanki 插件，或者像我做的免费 App InputConfig 这样的全系统映射工具，它给 Anki 发送普通的按键。把遥控器设为手柄模式，重新配对，然后两者选其一，不要同时用。

本页是按症状列出的修复清单。关于布局本身，Anki 手柄指南解释了每个按钮，设置 Anki 遥控器讲了第一次配对。

步骤

  1. 关闭遥控器，把它设为手柄模式：8BitDo Micro 用 D，Zero 2 则同时按住 A 和 Start。
  2. 在“系统设置”的 Bluetooth 里移除旧的条目，然后重新配对遥控器。
  3. 打开 InputConfig 的 Live Visualizer，按每个按钮，看看什么到达了 Mac。
  4. 启用内置的 Anki 预设，并打开 Switch presets when the front app changes。
  5. 如果装了 Contanki，InputConfig 运行时就把它关掉，或者反过来。

把症状对上修复办法

你看到的通常的原因修复
Contanki 显示 Controller not detected遥控器处在键盘模式，或者插件看不到手柄手柄模式，或全系统映射工具
遥控器输入字母，或者滚动卡片键盘模式，Micro 上的 K切换到 D，并重新配对
Bluetooth 显示已连接，Anki 却无视它没有任何东西在映射它Contanki，或 InputConfig 的 Anki 预设
每次按下都算两次同时有两个映射工具关掉一个
某个按钮始终没有任何作用手柄自己留着它，比如 D 模式下 Micro 上的 Star用另一个按钮
在 iPad 上能用，在 Mac 上不能AnkiMobile 有自己的手柄支持在 Mac 上用映射工具
macOS 更新之后就不行了有人在 Contanki 上报告过，没有确认的修复在 Live Visualizer 里检查，再试试全系统映射工具

先找到你的那一行，因为模式、配对和映射工具是三个不同的问题。

把遥控器设为手柄模式

大多数 Anki 遥控器是小小的 8BitDo 手柄，它在每种模式下都是不同的设备：

  • 8BitDo Micro。它底部边缘的开关有 S、D 和 K。D 是 InputConfig 能读取的普通游戏手柄，S 让它成为 Switch 手柄，K 让它成为输入固定字母的 Bluetooth 键盘。
  • 8BitDo Zero 2。它没有开关。同时按住 A 和 Start 开机，进入它的 macOS 模式，配对时显示为 Wireless Controller。R 加 Start 开机则是键盘模式。
  • 其他 8BitDo 手柄。Pro 2 用 D。SN30 Pro 或 SN30 Pro+ 要同时按住 B 和 Start 开机。
InputConfig 的主窗口，有一条写着 8BitDo controller detected in XInput mode 的提示，附有该型号的修复办法和一个 Help 按钮。
Figure 1. InputConfig 会点出处在 Mac 用不了的模式里的 8BitDo 手柄，并说明该选哪种模式，这是 Anki 遥控器看起来没反应时最先要查的。

键盘模式对 Anki 来说并不是错的，它只是另一条路：它输入的字母由 8BitDo 决定，很少和 Anki 的 Space 以及 1 到 4 对得上。想要自己的布局，就用手柄模式，并且要在配对之前设置好。

移除遥控器并重新配对

在一种模式下配对过的遥控器，在另一种模式下会显示为新设备，而旧的条目会碍事。

  • 你：打开“系统设置”的 Bluetooth，移除遥控器，按你选的模式开机，并让它进入配对模式。Micro 上按住 Pair 三秒，Zero 2 上按住 Select 三秒。
  • macOS：列出遥控器，带一个连接按钮。
  • 检查：它显示已连接，而且遥控器上的灯不再闪烁。

如果仍然配对不上，给它充电，放在离 Mac 近的地方，并确认它没有仍然和附近的 Switch 或手机配对。较旧的手柄可能需要用 8BitDo 的 Upgrade Tool 更新固件。Zero 2 的 USB 接口只用于充电和更新固件，所以它只能通过 Bluetooth 连接。每次更改模式，都要忘掉旧的条目。

当 Contanki 显示没有检测到手柄

Contanki 是一个免费插件，从 Anki 里面读取手柄，找不到手柄时，它会显示 Controller not detected。Anki 论坛上有几篇关于 Mac 上出现这种情况的报告。其中一篇 2025 年 9 月 8 日的 Zero 2 帖子，是遥控器在键盘模式下配对。另一篇2025 年 9 月 28 日的，是 MacBook 上的 Zero 2，重置插件并买了新遥控器之后仍然如此。第三篇2025 年 9 月 29 日的，是 PS5 手柄在 macOS 更新之后不再被检测到。我在 2026 年 10 月 27 日读到它们时，除了设置指南和联系插件作者之外，没有一篇有确认的修复。

有两条出路：

  • 给 Contanki 一个手柄。处在键盘模式的遥控器就是键盘，所以插件没有东西可检测。切换到手柄模式，重新配对。
  • 跳过 Anki 里面的检测。全系统映射工具读取手柄，并给 Anki 发送普通的按键，所以 Anki 看到的始终只是键盘。InputConfig 就是这样工作的，而且同一个手柄还能操作牌组列表、浏览器和 Mac 的其余部分。

如果你试 InputConfig，那一段时间里请把 Contanki 关掉。两个映射工具同时存在，会对每次按下回应两次，看起来就像遥控器坏了。

在 Live Visualizer 里看看 Mac 听到了什么

在改动其他任何东西之前，先弄清遥控器的按键究竟有没有到达 Mac。

  • 你：在 InputConfig 里打开 Anki 预设，开着 Live Visualizer，按遥控器上的每个按钮。
  • InputConfig：在手柄的图上，点亮到达的每个控件。
  • 检查：始终不亮的控件没有到达 Mac，所以请检查连接和模式开关。如果遥控器根本不在边栏里，就在菜单栏的 InputConfig, Devices 下勾选它。
InputConfig 内置的 Anki 预设，Live Visualizer 的说明在四个正面按钮上写着 Again、Hard、Good 和 Easy。
Figure 2. Live Visualizer 里的 Anki 预设。在这里按下后能点亮的按钮，说明已经到达 Mac，所以剩下的问题出在预设或 Anki 里，而不是 Bluetooth。

D 模式下的 Micro 把 Star 按钮留给自己，当作它自己的连发键，所以 Star 不会亮，也无法绑定。这是手柄的设计，不是故障。能亮起来的都可以绑定，不亮的就是连接或模式的问题。

启用 Anki 预设并保持开启

InputConfig 自带一个内置的 Anki 预设，在 Built-in Presets, Desktop & Productivity 下。A / Cross 发送 Space，先显示答案，再评为 Good。X / Square 发送 1 表示 Again，B / Circle 发送 2 表示 Hard，Y / Triangle 发送 4 表示 Easy，左肩键撤销，右肩键重播音频。

InputConfig 编辑器里打开的 Anki 预设，四个正面按钮的行发送 Space、1、2 和 4，左肩键发送 Command Z，右肩键发送 R。
Figure 3. Anki 预设的各行。如果某一行评了错误的答案，就在那一行上按 Scan，再按你想要的按钮，这一行就会移过去。

如果遥控器亮了而 Anki 没有反应，按这个阶梯往上走，从最小的一步开始：

  1. 把 Anki 带到前面。按键会发给最前面的 App，所以被其他 App 挡在后面的复习窗口什么也收不到。
  2. 检查预设在运行。预设页面上的按钮在运行时显示 Deactivate。在设置的 Advanced 里打开 Switch presets when the front app changes，预设列表里已有的 Anki 会自己启用它。
  3. 检查权限。InputConfig 需要“系统设置”的“隐私与安全”里的“无障碍”。菜单栏图标变成橙色，说明预设在等待它。
  4. 检查 Anki 自己的按键。如果你改过 Anki 的答案快捷键，就在那些行上重新按 Scan，再按你的新按键。

想让大按钮表示 Hard 或 Again 而不是 Good，免费的 Anki Spacebar Binder 插件可以改变 Space 在答案那一面的作用。

如果 Mac 重启，或者遥控器老是掉线

遥控器掉线通常是因为电池、它仍然配对着的另一台设备，或者手柄在一段时间没有输入后自己关机，当你在一张难卡片上停顿时，这看起来就像掉线。给它充电，把它从附近的其他设备上取消配对，再重新配对。

Mac 重启则不同。2025 年 8 月的一个论坛帖子描述了一台 macOS 15.6.1 的 MacBook Air M3，只要 8BitDo Micro 以 D 模式通过 Bluetooth 连接，它就会重启，崩溃日志指向 Apple 一个处理输入设备的进程。固件更新没有止住它，而且我读到时，帖子里没有确认的修复。映射工具治不了这个，因为它发生在任何 App 之下。如果手柄可以用线连接，就试试用线，也可以试试另一个手柄，并带着日志向 Apple 报告这次崩溃。在你排查期间，PS5、PS4、Xbox 或 Switch Pro 手柄，或者单个 Joy-Con，可以运行同一个 Anki 预设。

InputConfig 做不到什么

  • 停掉键盘模式遥控器的字母。它监听键盘，不会拦截或重映射按键，所以在键盘模式下，每个字母仍然会到达 Anki。配合 InputConfig 请用手柄模式。
  • 读取手柄自己留着的按钮。D 模式下 Micro 上的 Star 永远不会报告给 Mac。
  • 在 iPad 上运行。InputConfig 是 Mac App。在 iPad 上，AnkiMobile 有自己的手柄支持。
  • 修复 Bluetooth 崩溃。由 App 之下引起的重启，要交给 Apple 和手柄的厂商。

简短版

  • 模式。Micro 用 D，Zero 2 用 A 加 Start，然后忘掉并重新配对。
  • 检查。在 Live Visualizer 里按每个按钮。始终不亮的控件没有到达 Mac。
  • 映射。启用内置的 Anki 预设，并打开自动切换。
  • 一个映射工具。Contanki 或 InputConfig，不要同时用。

先从模式开关查起，因为大多数看起来没反应的 Anki 遥控器，都能用它解释。

常见问题

Anki 为什么显示没有检测到手柄？

这条消息来自 Contanki 插件。通常的原因是遥控器以键盘模式配对，对 Mac 来说它就是键盘，所以没有手柄可检测。把它切换到手柄模式并重新配对，或者使用像 InputConfig 这样的全系统映射工具，它给 Anki 发送普通的按键。

为什么我的遥控器输入字母，而不是给卡片评分？

它处在键盘模式，也就是 8BitDo Micro 上的 K，输入的是 8BitDo 的字母。把它切换到 D，重新配对，并启用 InputConfig 的 Anki 预设，它发送 Space 和 1 到 4。

我需要 Karabiner-Elements 吗？

只有当你让遥控器保持键盘模式、并想改变它输入的字母时才需要。在手柄模式下，是 InputConfig 或 Contanki 在做映射，Karabiner-Elements 不参与。

Anki 遥控器能在 iPad 上配合 InputConfig 使用吗？

不能。InputConfig 是 Mac App。iPad 上的 AnkiMobile 有自己的手柄支持，所以遥控器可能在那里能用，而在 Mac 上不能。

我需要插件吗？

不需要。InputConfig 发送普通的按键，这就是 Anki 所需要的全部。Contanki 是插件的路线，两者都行，但不要同时用。

更多中文页面

详细指南（英文）

作者说明。Ryleigh Newman 开发了 InputConfig，因为双手活动不便，每天都用手柄操作自己的 Mac。本页译自英文。Mac 的语言设为简体中文时，App 的主要按钮和菜单显示为中文，本页使用这些名称，并在括号中附上英文名称。App 的其他部分和网站的其他页面都是英文。

本页的其他语言版本： English, Deutsch, Español, Français, Italiano, 日本語, 한국어, Polski, Português, Русский, ไทย, 繁體中文

在 Mac App Store 下载 InputConfig免费。macOS 14 或更高版本。无需账户，数据不会离开你的 Mac。 源代码在 GitHub 上.