# 常见问题排查
表1常见问题排查 
| 问题                   | 原因                  | 解决                         |
|:---|:---|:---|
| 按键无反应                | 终端未聚焦。              | 单击终端窗口。                    |
| 按键无反应                | 窗口管理器抢占快捷键。         | 修改keymap换键。                |
| h键没反应                | 自定义keymap覆盖了默认。     | 改为merge或显式添加 "h": go_home。 |
| q键不能改                | 保留键。                | 不可更改，使用其他按键。               |
| 退出后终端箭头键失效           | cbreak未恢复。          | 已通过三层保护修复（v2）。             |
| pynput not available | 旧日志残留。              | 当前版本不再依赖pynput。            |
| 按了按键一直无响应            | keymap值指向了不存在的命令实例。 | 检查启动日志中是否有ValueError。      |