Mac系统Python虚拟环境无法找到MacPorts安装的hid库求排查方案

• 第一步验证路径问题是否为核心诱因，执行以下命令测试导入是否正常：

  DYLD_LIBRARY_PATH=/opt/local/lib python3 -c "import hid"
  

  若执行后无报错，说明仅为虚拟环境默认未加载MacPorts的库路径，按后续步骤配置即可。
• 临时生效方案：每次运行调用hid的Python程序前，先导出环境变量：

  export DYLD_LIBRARY_PATH=/opt/local/lib:$DYLD_LIBRARY_PATH
  

• 虚拟环境永久生效方案：编辑虚拟环境的激活脚本vtest/bin/activate，在文件末尾添加上述export命令，后续每次激活虚拟环境时会自动完成库路径配置。
• 架构一致性校验：如果第一步测试仍报错，检查动态库和Python的架构是否匹配，分别执行以下命令对比输出：

  # 查看hidapi动态库架构
  file /opt/local/lib/libhidapi.dylib
  # 查看当前虚拟环境Python的架构
  file $(which python3)
  

  若架构不一致（比如一个为x86_64一个为arm64），执行sudo port upgrade --force hidapi重新编译匹配当前系统架构的版本即可。
• 替代安装方案：如上述配置均无效，可卸载pip安装的hid包，改用MacPorts维护的对应版本Python的hid包，创建虚拟环境时开启系统站点包继承：

  # 卸载现有pip安装的hid
  pip uninstall -y hid
  # 安装MacPorts维护的py39-hid包
  sudo port install py39-hid
  # 重建虚拟环境，开启系统站点包继承
  virtualenv-3.9 --system-site-packages vtest
  source vtest/bin/activate
  

注意：macOS系统完整性保护（SIP）开启状态下，root权限运行的进程会自动清空DYLD_LIBRARY_PATH变量，不要使用sudo执行你的Python业务代码。

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