Ubuntu系统Python3中harfang导入失败求助：pip安装无效

问题原因 #

harfang模块未上传至PyPI官方源，因此直接执行pip install harfang会安装失败。

解决方法 #

方法1：从源码编译安装

这是最稳定可靠的解决方式，步骤如下：

• 先安装编译所需依赖：

  sudo apt update && sudo apt install git cmake python3-dev gcc g++ libssl-dev
  

• 克隆harfang源码（需同步子模块）：

  git clone --recursive https://github.com/harfang3d/harfang.git
  

• 进入源码目录并创建编译目录：

  cd harfang && mkdir build && cd build
  

• 配置cmake，指定Python3并开启Python绑定编译：

  cmake .. -DPYTHON_EXECUTABLE=$(which python3) -DBUILD_PYTHON_BINDINGS=ON
  

• 编译并安装：

  make -j$(nproc) && sudo make install
  

• 验证安装结果：

  python3 -c "import harfang; print(harfang.__version__)"
  

方法2：安装预编译Python绑定包

若不想编译源码，可找到对应Ubuntu版本的harfang Python wheel包（.whl格式），下载后本地安装：

pip3 install /path/to/your/harfang_python_package.whl

注意需匹配你的Ubuntu系统版本与Python3版本。

方法3：检查Python环境一致性

• 确保使用的pip对应Python3，避免与Python2的pip混淆，建议直接用pip3操作：

  pip3 install --upgrade pip
  

• 若使用虚拟环境，需先激活环境再执行安装或导入命令。

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