Jupyter Notebook导入torch报未找到模块但终端显示已装包的问题咨询

你遇到的导入报错并非pip路径配置异常，核心原因是Jupyter Notebook的运行内核绑定的Python环境，和你通过pip3安装torch的Python3.8环境相互独立。
从你给出的终端输出可以确认，torch、torchvision已经成功安装到/usr/local/lib/python3.8/site-packages路径下，安装流程本身没有问题。这类问题在Mac设备上非常常见：因为Mac系统会自带Python3.7版本，Jupyter默认绑定这个系统自带的Python解释器，和你手动安装的Python3.8的第三方包目录完全隔离，自然无法找到已安装的torch模块。

1. 核对两端Python路径，验证环境不匹配 #

先分别获取两个场景下的Python解释器路径，实锤问题诱因：

• 在.zsh终端执行命令，获取pip3关联的Python路径（也就是装了torch的环境）：
  which python3
  正常会输出类似/usr/local/bin/python3.8的结果。
• 在已打开的Jupyter Notebook中新建代码单元格，执行以下代码，获取Jupyter当前调用的Python路径：

  import sys
  print(sys.executable)
  

如果两个输出的路径不一致，就完全确认是环境不匹配导致的报错。

2. 将已安装torch的Python环境注册到Jupyter #

在.zsh终端依次执行以下命令，把装了torch的Python3.8环境添加到Jupyter的可选内核列表中：

• 给目标环境安装ipykernel组件（用于和Jupyter通信）：
  /usr/local/bin/python3.8 -m pip install ipykernel
• 注册自定义Jupyter内核：
  /usr/local/bin/python3.8 -m ipykernel install --user --name=torch_env --display-name "Python 3.8 (torch)"

3. 切换Jupyter运行内核 #

回到Jupyter Notebook界面操作：

• 点击顶部菜单栏的「Kernel」→「Change kernel」
• 选择刚才注册的 Python 3.8 (torch) 内核
• 新建代码单元格重新执行import torch，即可正常完成模块导入。

如果你仍想排查pip本身的路径配置是否正常，可以按以下方法检查：

• 在终端执行pip3 -V，查看输出的包安装路径是否和之前显示的/usr/local/lib/python3.8/site-packages一致，路径匹配就说明pip配置没有问题，不需要修改全局系统PATH。
• 如果本地安装过pyenv、Anaconda等Python版本管理工具，这类工具通常会在.zshrc配置文件中将自定义Python路径放在环境变量的优先位置，更容易造成多环境路径混乱。这类场景不需要修改全局PATH，按照上面的内核匹配方法操作即可，避免破坏其他开发工具的运行环境。

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