VSCode提示docopt导入无法解析但Bash终端可正常导入怎么办

问题根因 #

该问题的核心原因是VSCode Python扩展当前选中的Python解释器，和你终端中使用的Python解释器不属于同一个环境。
你终端中使用的是已安装docopt模块的Anaconda Python 3.9.6，但VSCode默认选中了其他未安装docopt的Python环境，因此Pylance扫描依赖时无法找到对应模块。

解决步骤 #

• 首先在可正常导入docopt的Bash终端执行命令，获取当前Python解释器的绝对路径：

which python3
# 若终端调用Python使用的是python命令，则执行 which python

记录返回的路径，格式类似/home/你的用户名/anaconda3/bin/python3.9。

• 打开VSCode中的main.py文件，点击界面右下角状态栏显示的Python版本号，弹出解释器选择列表。
• 若刚才记录的路径已在列表中，直接点击选中；若不在列表中，选择「输入解释器路径」，粘贴之前记录的路径并确认。
• 等待Pylance重新加载代码索引后，报错会自动消失。

异常情况排查 #

如果选中正确解释器后仍有报错，可通过以下配置修复：

• 打开VSCode设置，搜索python.analysis.extraPaths，将docopt模块的安装路径添加到该配置项中。你可以在终端执行以下代码获取docopt的安装路径：

import docopt
print(docopt.__file__)

取输出路径的上层目录，添加到extraPaths即可。

• 若你使用了虚拟环境，确认VSCode没有自动切换回系统默认Python环境，重新手动选择虚拟环境内的Python解释器即可。

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