常见问题排查

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