已安装docopt仍提示ModuleNotFoundError: No module named 'docopt'求助

这种情况我之前帮好几个开发者排查过，核心原因基本都是Python环境不匹配——你用pip3把包装到了Python3的环境里，但运行脚本时用的是另一个Python版本（比如Python2），或者环境路径没对应上。咱们一步步来解决：

1. 确认Python版本与pip版本的对应关系 #

先搞清楚你的pip3到底绑定了哪个Python版本，以及你运行脚本用的是哪个Python：

• 执行pip3 -V，会输出类似这样的内容：

  pip 10.0.0 from /usr/local/lib/python3.6/site-packages/pip (python 3.6)
  

  这里的python 3.6就是pip3对应的Python版本。
• 再检查你运行脚本的Python版本：
  • 如果用python your_script.py运行，就执行python -V看版本；
  • 如果用python3 your_script.py，就执行python3 -V。
• 如果两个版本不一致（比如pip3对应Python3.6，但python对应Python2.7），那肯定找不到包！把运行命令改成python3 your_script.py就能解决。

2. 排查虚拟环境的影响 #

如果你平时用虚拟环境管理项目依赖，大概率是装包和运行脚本时的环境不统一：

• 看终端提示符开头有没有(venv)这类前缀，有就说明当前激活了虚拟环境；没有就是在全局环境。
• 如果装docopt时没激活虚拟环境，但运行脚本时激活了，或者反过来，都会导致找不到包。解决方法：
  • 激活项目对应的虚拟环境，重新执行pip3 install docopt；
  • 或者运行脚本时确保激活了装包时的环境。

3. 强制指定Python版本安装和运行 #

有时候pip3可能对应多个Python3子版本（比如3.6、3.7），这时候直接指定版本操作更稳妥：

• 安装时用：python3.6 -m pip install docopt（把3.6换成你pip3 -V里看到的版本号）；
• 运行脚本时用：python3.6 your_script.py，确保和安装时的版本完全一致。

4. 验证包的安装路径是否在Python搜索路径里 #

如果上面的方法都没用，就检查Python能不能找到docopt的安装路径：

• 执行python3 -c "import sys; print(sys.path)"，输出的列表里应该包含pip3 -V显示的site-packages路径（比如/usr/local/lib/python3.6/site-packages）；
• 如果没找到这个路径，说明Python环境配置有问题，你可以手动把路径添加到脚本开头：

  import sys
  sys.path.append("/usr/local/lib/python3.6/site-packages") # 替换成你的site-packages路径
  import docopt
  

  或者重新安装docopt到正确的路径中。

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