本地pyenv环境中运行的Jupyter Notebook无法识别pip安装的包

核心问题 #

Jupyter Notebook 未关联到你当前的 pyenv 虚拟环境，导致它调用的 Python 解释器和你安装包的解释器不一致。

分步解决 #

1. 激活虚拟环境并安装依赖
   确保你在目标虚拟环境中，先激活它：

   source ~/.venv/bin/activate
   

   然后安装 Jupyter 和内核管理工具（如果虚拟环境里还没装）：

   pip install jupyter ipykernel
   

2. 将虚拟环境注册为 Jupyter 内核
   把当前虚拟环境的 Python 解释器注册成 Jupyter 可识别的内核：

   python -m ipykernel install --user --name=venv-kernel --display-name="Pyenv Venv Kernel"
   

   这里的 name 和 display-name 可以自定义，方便你在 Jupyter 里识别。

3. 启动 Jupyter 并选择正确内核
   在虚拟环境中启动 Jupyter Notebook：

   jupyter notebook
   

   新建 Notebook 时，在「Kernel」→「Change Kernel」菜单里选择你刚才注册的 Pyenv Venv Kernel。

4. 验证环境一致性
   在 Notebook 中运行以下代码，确认当前使用的 Python 解释器路径和虚拟环境匹配：

   import sys
   print(sys.executable)
   

   输出应为 ~/.venv/bin/python。

额外排查 #

如果之前有错误的内核残留，可以先清理：

• 列出所有已注册的内核：

  jupyter kernelspec list
  

• 删除错误的内核：

  jupyter kernelspec remove <错误内核名称>
  

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