虚拟环境中Jupyter启动异常：Python路径不符且依赖库缺失

问题根源 #

在虚拟环境内直接安装Jupyter后，若未将虚拟环境的Python解释器注册为Jupyter专属内核，Notebook会默认调用全局Python，导致解释器路径不匹配、虚拟环境内的依赖库无法被加载。

修复步骤 #

1. 保持虚拟环境处于激活状态：

   source venv/bin/activate
   

2. 安装ipykernel工具（用于管理Jupyter内核）：

   pip install ipykernel
   

3. 将当前虚拟环境注册为Jupyter内核：

   python -m ipykernel install --user --name=venv-custom --display-name="Python (虚拟环境venv)"
   

   • --name：内核的内部标识名，可自定义
   • --display-name：Jupyter界面中显示的内核名称，建议设置为易识别的名称

4. 重启Jupyter Notebook，切换到新内核：
   打开Notebook后，点击顶部菜单栏的Kernel → Change Kernel，选择刚才注册的Python (虚拟环境venv)内核。此时执行sys.executable会返回虚拟环境的Python路径，依赖库也能正常调用。

可选：清理无用内核 #

如果后续不再需要该虚拟环境内核，可执行以下命令删除：

jupyter kernelspec uninstall venv-custom

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