Visual Studio Code Python模块找不到问题求助（OS X环境）

核心原因：Python环境不一致 #

OS X自带Python，加上你可能安装的第三方Python版本（比如Homebrew或官网下载的），很容易出现pip安装的模块和运行代码的Python不属于同一个环境的情况，这是这类问题最常见的根源。

步骤1：确认当前运行代码的Python路径 #

在终端和VS Code的内置终端里分别执行以下命令，记录输出的路径和版本：

which python
which python3
python --version
python3 --version

比如输出可能是系统自带的/usr/bin/python，或是Homebrew安装的/usr/local/bin/python3。

步骤2：确认pip对应的Python环境 #

执行以下命令，对比和上一步的Python路径是否匹配：

which pip
which pip3
pip --version
pip3 --version

如果运行代码用的是python3，但pip对应的是系统Python2，就会出现模块安装后找不到的问题。

步骤3：用对应环境的pip重新安装模块 #

直接通过Python的-m pip方式安装，确保环境完全匹配：

# 若运行代码用的是python3
python3 -m pip install pandas numpy
# 若用的是python（注意OS X自带的python多为Python2，建议优先用python3）
python -m pip install pandas numpy

步骤4：VS Code中指定正确的Python解释器 #

打开VS Code，按下Cmd+Shift+P，输入Python: Select Interpreter，选择和你刚才确认的、已安装模块的Python版本一致的解释器（比如显示Python 3.x.x (/usr/local/bin/python3)的选项）。

步骤5：排查虚拟环境问题 #

如果你之前用过虚拟环境，可能代码正运行在未安装模块的虚拟环境中：

• 检查终端命令行开头是否有(env名称)的标识，有的话执行deactivate退出虚拟环境，再运行代码试试。
• 若需要在虚拟环境中运行，进入对应虚拟环境后重新执行pip install pandas numpy。

步骤6：极端情况：重置Python环境（谨慎操作） #

如果以上方法都无效，可尝试卸载第三方Python版本（比如Homebrew安装的）：

brew uninstall python

然后从Python官网重新下载安装最新版，安装时务必勾选Add Python to PATH选项，之后再用python3 -m pip install安装所需模块。

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