Win10 64位Python已安装curses.whl仍报No module named '_curses'错误求助

报错原因 #

• whl包版本与Python环境不匹配
  非官方Windows版curses包对版本匹配要求极高，包的版本必须同时匹配你本地Python的大版本、小版本、运行架构：比如你使用Python 3.10 64位，就必须安装文件名包含cp310、win_amd64标识的whl包，若下载的包对应版本为cp39、或架构为win32，哪怕安装过程无报错，导入时也会触发该异常。
  你可以执行以下命令核对本地环境参数：

# 查看Python版本
python --version
# 查看Python运行架构
python -c "import platform;print(platform.architecture()[0])"

将返回结果和你安装的whl文件名做比对，确认参数完全一致。

• 多Python环境冲突
  如果本地存在多个Python版本（比如同时安装了Python3.9和3.10、或者启用了项目虚拟环境），安装whl时调用的pip对应的Python环境，和运行代码时调用的Python环境不属于同一个，就会出现「安装成功但导入失败」的问题。
  你可以执行pip --version查看当前pip绑定的Python路径，和你运行代码时使用的Python路径做比对，确认路径一致。
• 旧版本残留或安装不完整
  之前安装过错误版本的curses包，残留的文件没有被正常覆盖，也会导致导入异常。

修复步骤 #

• 先卸载当前已安装的curses包，清除残留：

pip uninstall -y curses

• 下载和本地Python环境完全匹配的curses whl安装包
• 用对应环境的pip绝对路径执行安装，避免环境识别错误：

# 替换为你本地对应Python环境的pip路径、以及whl包的本地全路径
C:\Python310\Scripts\pip.exe install D:\download\curses-2.2.1-cp310-cp310-win_amd64.whl

• 验证安装结果，执行以下命令无报错则说明安装成功：

python -c "import curses;print('导入成功')"

• 若使用PyCharm、VSCode等IDE运行代码，进入项目的解释器配置页，确认当前项目绑定的解释器就是已经成功安装curses的Python环境，避免IDE调用错误的解释器触发异常。

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