pyenv与pipenv环境下Jupyter Notebook异常问题求助

我之前也碰到过一模一样的坑！用pyenv管理多版本Python，搭配pipenv管虚拟环境本来顺畅得很，结果一切换到Jupyter Notebook就出现环境泄漏——明明激活了pipenv的隔离环境，Notebook里却能调用全局或者其他环境的包，折腾了好一阵才找到根源和解决办法，分享给你：

问题根源 #

Jupyter Notebook默认会绑定系统全局的IPython内核，而pipenv创建的虚拟环境是完全隔离的，Jupyter没法自动感知到这个独立环境的存在，导致运行代码时会“串用”其他环境的依赖，也就是你说的环境泄漏。

分步解决方案 #

1. 在pipenv虚拟环境内安装ipykernel #

首先进入你的项目目录，激活pipenv虚拟环境：

cd your-project-dir
pipenv shell

然后在这个激活的环境里安装ipykernel（一定要在虚拟环境内装，别装到全局！）：

pip install ipykernel

2. 将pipenv虚拟环境注册为Jupyter独立内核 #

执行下面的命令，把当前虚拟环境注册成Jupyter能识别的专属内核：

python -m ipykernel install --user --name=your-pipenv-env-id --display-name="Python (pipenv-你的项目名)"

• --name：内核的唯一标识ID，建议用项目名+env来命名，比如my-blog-env
• --display-name：在Jupyter Notebook界面里显示的名字，方便你区分不同环境，比如Python (pipenv-my-blog)

3. 在Jupyter中选择正确的内核 #

打开Jupyter Notebook后，无论是新建笔记还是打开已有文件，点击顶部菜单栏的「Kernel」→「Change Kernel」，选择你刚才注册的那个pipenv专属内核。这样运行的代码就会完全使用该虚拟环境的依赖，再也不会出现环境泄漏的问题了。

额外注意事项 #

• 每个新的pipenv虚拟环境都需要重复上述步骤，因为每个环境都是隔离的，Jupyter不会自动同步
• 如果之后删除了某个pipenv虚拟环境，记得同步删除对应的Jupyter内核：

jupyter kernelspec uninstall your-pipenv-env-id

• 确保你始终在pipenv激活的环境内安装依赖和ipykernel，避免全局环境干扰

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