cmd中运行Python程序遇ModuleNotFound错误但pip正常的解决方法

以下是针对性的排查和解决步骤：

1. 验证Python与Pip的版本匹配性 #

• 在CMD中分别执行：

  python --version
  pip --version
  

• 查看输出的版本号和路径是否一致。如果Pip对应的Python版本（比如pip3对应python3）和CMD中默认调用的python版本不同，说明模块被安装到了另一个Python环境中，当前CMD使用的解释器找不到。
• 解决：使用匹配版本的命令运行脚本，比如用python3 脚本名.py，或者用对应版本的Pip重新安装模块（pip3 install 模块名）。

2. 对比Python的模块搜索路径 #

• 在CMD中执行：

  python -c "import sys; print('\n'.join(sys.path))"
  

• 同时在IDLE中执行同样的代码，对比两者的输出路径。如果CMD的路径列表中缺少Pip安装模块的site-packages目录，说明当前CMD使用的Python解释器环境与IDLE/PyCharm不一致。
• 解决：检查系统环境变量PATH，确保CMD优先调用的是IDLE/PyCharm使用的Python版本。

3. 排查虚拟环境差异 #

• 如果PyCharm使用了虚拟环境，模块会被安装到虚拟环境的site-packages目录中，而CMD默认调用的是全局Python环境，自然找不到模块。
• 解决：在CMD中激活对应的虚拟环境后再运行脚本。Windows下激活命令示例：

  虚拟环境目录\Scripts\activate
  

  激活后命令行前缀会出现虚拟环境名称，此时再执行python 脚本名.py即可。

4. 临时解决方案（不推荐长期使用） #

• 若暂时无法调整环境，可在脚本开头手动添加模块所在路径：

  import sys
  # 替换为你的模块实际安装路径
  sys.path.append("C:\\PythonXX\\Lib\\site-packages")
  

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