如何为Python 3.10.8安装hidapi模块并解决导入失败问题

问题根源 #

你遇到的ImportError是因为Python 3.10无法找到hidapi依赖的底层动态库。虽然你通过Python 3.10的pip安装了hidapi模块，但该模块需要系统级的libhidapi.dylib文件支持——你之前卸载brew版hidapi后，系统中就缺失了这个关键库文件。

完整解决步骤 #

1. 重新安装系统级hidapi库 #

通过brew安装底层的hidapi库：

brew install hidapi

2. 确认库文件位置 #

执行以下命令确认libhidapi.dylib的路径：

ls -l /usr/local/lib/libhidapi.dylib

输出会类似：

lrwxr-xr-x  1 user  admin  44  5 10 12:34 /usr/local/lib/libhidapi.dylib -> ../Cellar/hidapi/0.14.0/lib/libhidapi.dylib

3. 让Python 3.10识别到库文件 #

以下三种方式任选其一：

方式一：临时生效（单次终端会话）

在运行Python前设置环境变量：

export DYLD_LIBRARY_PATH="/usr/local/lib:$DYLD_LIBRARY_PATH"
python3

此时在Python交互环境中执行import hid即可成功。

方式二：永久生效（推荐）

编辑你的shell配置文件（如~/.zshrc，若用bash则是~/.bash_profile），添加以下内容：

export DYLD_LIBRARY_PATH="/usr/local/lib:$DYLD_LIBRARY_PATH"

保存后执行source ~/.zshrc（对应你的shell文件）使配置立即生效，之后每次打开终端都无需重复设置。

方式三：创建软链接

将库文件链接到Python 3.10的库目录：

sudo ln -s /usr/local/lib/libhidapi.dylib /Library/Frameworks/Python.framework/Versions/3.10/lib/

输入你的用户密码确认执行即可。

4. 安装/升级Python 3.10的hidapi模块 #

确保使用Python 3.10对应的pip安装模块：

python3 -m pip install --upgrade hidapi

验证安装 #

打开Python 3.10交互环境测试：

python3

执行以下代码：

import hid
print(hid.__version__)

若没有报错并输出版本号，说明安装成功。

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