ZSH环境下Python3及Jupyter Notebook无法找到numpy模块求助

我之前也碰到过类似的shell环境变量加载异常的情况，结合你的描述，核心问题大概率是直接启动ZSH时，Python的模块搜索路径没有包含numpy所在的目录，而切换bash再切回ZSH的过程中，环境变量被正确加载了。给你几个具体的排查和解决步骤：

1. 对比两种场景下的Python模块路径 #

先分别在两种场景下进入Python3解释器，执行以下命令查看模块搜索路径：

import sys
print(sys.path)

• 场景1：直接打开ZSH控制台，进入Python3执行上述命令
• 场景2：打开ZSH→切bash→切回ZSH，进入Python3执行上述命令

对比两次输出的路径列表，找到numpy所在的目录（通常是类似/usr/local/lib/python3.x/site-packages或者虚拟环境下的对应路径），看它在场景1中是否缺失。

2. 检查PYTHONPATH环境变量的差异 #

在两种场景下的ZSH控制台中，分别执行：

echo $PYTHONPATH

如果场景1的PYTHONPATH为空或者缺少numpy所在的路径，那就是环境变量没有正确设置的问题。

3. 排查ZSH的配置脚本加载逻辑 #

直接打开控制台启动的ZSH属于登录shell，会优先加载~/.zprofile、~/.zlogin这类登录脚本；而从bash切换回ZSH属于非登录shell，只会加载~/.zshrc。如果你的Python环境变量（比如PYTHONPATH）只配置在了~/.zshrc里，那登录shell启动时可能没加载到。

解决办法：

• 把Python相关的环境变量配置移到~/.zprofile里，或者在~/.zprofile中添加一行：source ~/.zshrc，确保登录shell也能加载到zshrc的配置。

4. 检查是否存在虚拟环境干扰 #

如果你使用了Python虚拟环境，可能直接启动ZSH时没有自动激活虚拟环境，但切换shell的过程中触发了激活脚本。可以检查ZSH的配置脚本里是否有自动激活虚拟环境的命令，或者手动在场景1中激活对应的虚拟环境，看numpy是否能正常导入。

5. 强制指定numpy路径（临时验证） #

如果确认了numpy所在的路径，也可以在场景1的Python3中手动添加路径验证：

import sys
sys.path.append("/path/to/numpy/site-packages")
import numpy

如果这样能成功导入，就说明确实是路径缺失的问题，按照步骤3的方法永久配置即可。

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