Arduino Keyboard库编译报错：'Keyboard'未声明，求解决方法

问题代码 #

#include <Keyboard.h>

void setup() {
  Keyboard.begin();
  
  Keyboard.print("Hello!");
}

编译错误信息 #

C:\Users\nobody\sketch_feb12a\sketch_feb12a.ino: In function 'void setup()':
C:\Users\nobody\sketch_feb12a\sketch_feb12a.ino:4:3: error: 'Keyboard' was not declared in this scope
   Keyboard.begin();
   ^~~~~~~~

exit status 1

Compilation error: 'Keyboard' not found. Does your sketch include the line '#include <Keyboard.h>'? 

用户疑问 #

已尝试通过ZIP包和库管理器安装Keyboard.h库，请问需要修改什么来解决该问题？

解决步骤 #

• 确认开发板兼容性：Keyboard库仅支持原生USB HID功能的Arduino板，比如Leonardo、Micro、Pro Micro、ESP32等。如果用的是Uno、Nano这类仅靠USB转串口芯片通信的板子，无法使用该库，需更换支持HID的开发板。
• 检查库安装路径与名称：手动ZIP安装时，解压后的库文件夹必须命名为Keyboard（不能是Keyboard-master这类带后缀的名称），且要放在Arduino默认库目录（通常是文档\Arduino\libraries）下。
• 重启Arduino IDE：IDE有时不会实时识别新安装的库，重启后再重新编译项目。
• 更新Arduino IDE：旧版本IDE可能存在库识别bug，升级到最新版本可解决部分兼容性问题。
• 规范代码（可选）：在setup函数末尾添加Keyboard.end();，释放HID资源，虽然不是解决当前报错的直接方法，但能让代码更规范。

内容的提问来源于stack exchange，提问作者fleischermeister michael