ImportError: cadquery无法确定freecad库路径的原因及解决方案咨询

• 旧版cadquery 1.2.0的内置FreeCAD路径搜索逻辑仅覆盖系统默认安装路径，conda环境下安装的FreeCAD路径不在默认搜索列表内，无法被自动识别。
• 虚拟环境的系统环境变量配置缺失，FreeCAD的库目录未加入PATH或PYTHONPATH，cadquery执行路径扫描时无法定位到对应文件。
• 安装的FreeCAD版本与cadquery 1.2.0不兼容，该版本cadquery仅适配FreeCAD 0.18.x系列，版本过高或过低都会导致路径识别失败。
• FreeCAD未安装在当前激活的python2虚拟环境中，而是被安装到了base环境或系统全局路径，虚拟环境的运行上下文无法读取外部环境的安装目录。

• 手动指定FreeCAD库路径，在导入cadquery的代码前加入路径声明，示例如下：

import sys
# 路径替换为你当前conda环境中FreeCAD库的实际所在目录
sys.path.append("/Users/vid/opt/anaconda3/envs/python2/lib/FreeCAD")
import cadquery as cq

如果不确定FreeCAD的库路径，可在激活虚拟环境后执行find /Users/vid/opt/anaconda3/envs/python2 -name "FreeCAD.so" 2>/dev/null搜索，将返回结果的父目录填入即可。

• 临时配置环境变量，激活虚拟环境后执行以下命令再运行代码：

export FREECAD_LIB=/Users/vid/opt/anaconda3/envs/python2/lib/FreeCAD
export PYTHONPATH=$FREECAD_LIB:$PYTHONPATH
export PATH=$FREECAD_LIB:$PATH

• 安装匹配版本的FreeCAD，cadquery 1.2.0的适配版本为FreeCAD 0.18.x，在虚拟环境中执行conda install freecad=0.18 -c conda-forge即可替换为兼容版本。
• 确认依赖安装范围，激活python2虚拟环境后执行conda list检查包列表，确认freecad和cadquery都属于当前环境的安装包，若freecad未出现在列表中，需重新在当前环境执行安装操作，不要将依赖安装到base等其他环境。

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