LVGL键盘布局与自定义：从一次诡异的输入乱码说起去年做一款工业手持终端，客户反馈在输入设备序列号时，数字键盘按“1”出来的是“q”，按“0”出来的是“p”。排查了一整天，最后发现是LVGL默认的键盘布局和物理键盘矩阵的映射表对不上。那个项目用的是4x4矩阵键盘，硬件上把数字键排成了电话键盘布局，而LVGL的lv_keyboard组件默认是PC键盘的QWERTY排列。从那以后，我养成了一个习惯：凡是涉及键盘输入的项目，第一件事就是检查布局映射。LVGL键盘组件的“默认陷阱”lv_keyboard是LVGL内置的文本输入辅助组件，它本质上是一个封装好的按钮矩阵，每个按钮绑定了一个键值。当你调用lv_keyboard_create(lv_scr_act())时，它默认生成的是类似手机输入法的布局——第一行QWERTYUIOP，第二行ASDFGHJKL，第三行ZXCVBNM，底部带退格、回车和空格。但这里有个坑：这个默认布局是给触摸屏用的，每个按键的lv_btnmatrix索引和lv_keyboard_def_btn_map中的字符一一对应。如果你用的是物理键盘，或者需要自定义按键排列（比如只保留数字和确认键），直接调用默认布局就会出问题。更隐蔽的是，LVGL的键盘组件内部维护了一个“当前模式”状态机——普通模式、数字模式、符号模式。切换模式时，按键映射表会整体替换，如果你自定义了布局但没有正确处理模式切换，用户按“123”按钮切换到数字键盘后，所有按键都会变成默认布局，你的自定义就白费了。