QGIS插件导入python-ternary模块遇ModuleNotFoundError问题求助

算力阿峰

2026-8-6

QGIS插件导入python-ternary模块失败的排查方案

核心排查与解决步骤

确认QGIS的Python环境：QGIS自带独立Python环境，你用pip安装模块时可能用的是系统/其他虚拟环境的pip，而非QGIS内置版本。在QGIS的Python控制台执行以下命令，查看当前环境的site-packages路径：
```
import sys
print([p for p in sys.path if 'site-packages' in p])
```
对比你安装python-ternary的路径，若不一致，说明模块装错了环境。
用QGIS内置pip重装模块：找到QGIS安装目录下的pip工具（一般路径为QGIS安装目录\apps\PythonXX\Scripts\pip.exe，XX对应Python版本号），打开命令行执行：
```
"C:\Program Files\QGIS 3.XX\apps\Python39\Scripts\pip.exe" install python-ternary
```
替换路径为你实际的QGIS Python路径。
验证版本兼容性：检查python-ternary版本与QGIS内置Python版本是否匹配。QGIS 3.x通常搭配Python 3.9/3.10，若版本不兼容，尝试安装适配的旧版本：
```
# 示例：安装适配Python3.9的版本
"QGIS的pip路径" install python-ternary==1.0.8
```
手动添加路径（临时方案）：若确认模块在site-packages但QGIS未识别，可在插件代码开头手动添加路径：
```
import sys
sys.path.append("你的python-ternary所在site-packages路径")
import ternary
```
注意路径使用正斜杠/或双反斜杠\\。
检查模块完整性：删除site-packages下的ternary文件夹和python_ternary-*.dist-info文件夹，再用QGIS的pip重新安装，避免安装不完整导致的问题。