MacOS下Jupyter Notebook导入pandas遇ModuleNotFoundError求助

一、先修复终端pip无法识别的问题 #

Mac系统默认Python3对应的包管理工具是pip3，可通过以下方式让终端识别pip：

• 给pip3添加别名：在终端执行 echo "alias pip='pip3'" >> ~/.zshrc（若使用bash则替换为~/.bash_profile），再执行 source ~/.zshrc 使设置生效。
• 后续安装包时，直接用pip3代替pip执行命令也可。

二、确保Jupyter使用的Python环境已安装pandas #

方法1：在Jupyter内直接安装 #

打开Jupyter Notebook，新建代码单元格，运行：

!pip3 install pandas

（若已设置pip别名，也可执行!pip install pandas）

方法2：匹配Jupyter的Python环境安装 #

1. 在Jupyter的代码单元格中运行以下代码，获取当前使用的Python路径：

import sys
print(sys.executable)

会得到类似/usr/local/bin/python3或/Users/xxx/opt/anaconda3/bin/python的路径。
2. 复制该路径到终端，执行：

# 替换为你获取到的Python路径
/usr/local/bin/python3 -m pip install pandas

此操作可确保pandas安装在Jupyter正在使用的Python环境中。

方法3：切换Jupyter内核到对应环境 #

1. 在终端执行 jupyter kernelspec list，查看所有可用内核及其关联的Python路径。
2. 若内核路径与安装pandas的环境不一致，可执行以下步骤：
   • 安装对应环境的ipykernel：pip3 install ipykernel
   • 将该环境添加为Jupyter内核：python3 -m ipykernel install --user --name=myenv（myenv为自定义内核名称）
   • 打开Jupyter Notebook后，通过顶部菜单栏「Kernel」切换到新添加的内核。

三、关于brew和pipx安装的说明 #

• brew安装的pandas属于系统级Python环境，大概率和Jupyter使用的环境不匹配，无法被Jupyter识别。
• pipx是用于安装Python命令行工具的工具，不是用来给当前环境安装库的，因此用pipx装pandas对Jupyter无效，后续请勿用pipx安装此类库。

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