Windows下Python2.7导入sentinelhub报无模块错误如何解决

核心排查方向 #

• 版本兼容性问题
  Python 2.7.18已经停止官方维护多年，目前sentinelhub所有近期发布的版本最低要求Python 3.8及以上运行环境。你直接执行pip install sentinelhub时，pip不会为Python2.7安装适配的可用版本，所谓的安装完成提示大概率是pip的异常匹配结果，或者把包装到了其他Python环境中，当前pyshell对应的Python2.7环境里根本没有可用的sentinelhub包。
• 多环境pip路径不匹配问题
  Windows系统下如果安装了多个Python版本，直接在命令行调用pip很可能对应到其他版本的Python，和你打开pyshell运行的Python不是同一个环境，属于Windows平台Python开发最常见的环境冲突问题。
  你可以先在当前报错的pyshell中执行以下代码，确认当前运行的Python实际路径：

  import sys
  print(sys.executable)
  

  记下输出的完整路径（例如C:\Python27\python.exe），之后在命令行中用该路径调用pip执行安装，确保包装到对应环境：

  C:\Python27\python.exe -m pip install sentinelhub
  

  执行后如果依然报导入错误，即可确认是Python版本不兼容导致的问题。

可行解决建议 #

• 优先升级Python版本：直接卸载Python2.7，安装3.8及以上的Python稳定版本（推荐3.9、3.10版本），安装时务必勾选Add Python to PATH选项。安装完成后新开命令行窗口，执行python --version确认输出为3.x版本，再执行pip install sentinelhub完成安装，之后打开pyshell导入即可正常使用。
• 不推荐的备选方案：如果因特殊原因必须保留Python2.7，只能尝试安装2020年之前发布、最后兼容Python2.7的极旧版本sentinelhub，但这类旧版本接口和当前Sentinel Hub官方服务已经不兼容，基本无法正常调用数据接口，没有实际使用价值。
• 安装验证技巧：每次装完包后，在对应Python环境中执行pip list | findstr sentinelhub，如果输出内容里能看到sentinelhub及对应版本号，才说明包确实安装到了当前激活的环境中。

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