USB 与 bootloader
无法进入刷写模式
- 更换稳定数据线并重新连接。
- 按对应机型的引导模式步骤重试（见
有线刷写）。
刷写失败
- 检查固件是否与机型/rev/布局一致。
- 重新下载固件后再次刷写。
刷写后部分按键异常
- 先恢复到该机型推荐固件版本。
- 确认是否使用了不匹配的 keymap。
无线连接（BLE / 2.4G / 配对槽位）
无线搜索不到设备
- 确认已按目标通道键（
2.4G 或 BLE1~BLE5）。
- 按
PAR 强制配对后重试。
- 执行
CLR（双击确认）后重新配对。
Bluefruit 出现粘键 / 按键卡住
- 先用有线模式确认矩阵正常。
- Bluefruit 使用 AT 文本协议，高速连续输入时可能丢字符；详见
旧版 BLE 固件。
迁移到 DuoChord 后无线不工作
- 确认已按
首次迁移 的固定顺序：
刷 AVR DuoChord 固件 → 左右 Shift + F 进入 DfuTarg → OTA → 重新配对。
VIA / Vial 无法识别
- Trichord 机型：先按左右
Shift + U 切换到 USB 模式。
- 更换数据线并确认机型/rev 正确。
灯光、encoder、磁轴等功能
- 灯光/encoder 异常：确认刷的是对应机型与 rev 的固件（Skog rev A/B 不可互刷）。
- F60 revM 磁轴行为异常：确认刷的是
F60 revM 固件，磁轴细节以实机为准。
按型号汇总的已知问题
- 各机型页的「故障排查」章节会列出本机型独有症状；无独有症状的机型直接参考
本页公共条目。