Linux环境安装Node.js usb@0.3.11模块因libusb-1.0缺失报错的解决求助

本次安装失败完全不是usb@0.3.11包自身的代码缺陷，本质是当前Linux运行环境缺少编译Node原生绑定模块必须的系统级依赖：

• usb@0.3.11是基于libusb C库实现的原生模块，安装阶段需要调用pkg-config工具读取libusb的头文件路径、动态库链接参数来完成编译流程
• 你当前系统中没有安装带pkg-config描述文件（即libusb-1.0.pc）的libusb开发包，直接触发了日志中No package 'libusb-1.0' found的中断，后续node-gyp的编译流程也会直接终止。

1. 补装系统依赖包 #

从你日志里的内核版本（2.6.32-573.18.1.el6.x86_64）可以判断当前是CentOS 6.x环境，直接执行yum安装对应依赖即可：

yum install -y libusbx-devel pkgconfig make gcc gcc-c++ python2

注意：CentOS 6官方软件源中，libusb-1.0的开发包命名为libusbx-devel，安装完成后libusb-1.0.pc会自动部署到pkg-config的默认搜索路径下，无需手动修改环境变量。

安装完成后可以先手动验证依赖是否被正常识别：

pkg-config --exists libusb-1.0 && echo "libusb依赖配置正常"

如果输出提示为libusb依赖配置正常，说明依赖校验已经通过。

2. 重新执行模块安装 #

依赖校验通过后，直接重跑原来的安装命令即可：

npm i usb@0.3.11

• 如果安装完上述依赖仍然提示找不到libusb-1.0.pc，可以全局检索该文件的实际存放路径：

  find / -name "libusb-1.0.pc" 2>/dev/null
  

  如果检索到的路径不在pkg-config默认搜索范围内，手动将该路径追加到PKG_CONFIG_PATH环境变量即可，例如文件位于/usr/local/lib/pkgconfig/下，就执行：

  export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig/
  

• 你当前使用的Node版本为v0.10.26、npm版本为1.4.3，配套的node-gyp v0.12.2与usb@0.3.11版本完全兼容，无需升级node、npm或node-gyp版本，强行升级反而会引发新的编译兼容问题。

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