Ubuntu20.04下npm install robotjs遇gyp ERR!错误求助

核心问题 #

报错关键信息：

../src/keycode.h:112:10: fatal error: X11/Xutil.h: No such file or directory

这是因为Linux系统缺少Robotjs编译所需的X11图形开发库依赖，导致编译无法完成。

解决步骤 #

• 安装X11开发依赖包
  根据你的Linux发行版执行对应命令：

  • Debian/Ubuntu 系列（适配你的VirtualBox环境）：

    sudo apt-get update
    sudo apt-get install libx11-dev libxtst-dev libpng-dev
    

  • RHEL/CentOS 系列：

    sudo yum update
    sudo yum install libX11-devel libXtst-devel libpng-devel
    

• 清理安装缓存（可选但推荐）
  移除之前失败的安装残留，避免干扰：

  npm cache clean --force
  rm -rf node_modules package-lock.json
  

• 重新安装robotjs

  npm install robotjs
  

额外提示 #

• 当前使用的Node版本为v12.22.9，若安装仍失败，可尝试升级Node至长期支持版本（如v16.x、v18.x），Robotjs对新版本Node兼容性更好。
• 确保VirtualBox虚拟机已开启图形界面支持，Robotjs依赖X11会话才能正常工作。

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