如何使基于venv的JupyterHub内核中!pip install命令生效？

以下是几种实用的解决方法，按便捷性排序：

1. 使用Jupyter内置的%pip魔法命令（推荐） #

Jupyter自带的%pip魔法命令会自动绑定当前内核对应的Python环境，无需担心PATH优先级问题。直接在Notebook单元格中执行：

%pip install pandas

这个命令会直接调用venv内的pip，安装的包也会直接归属到当前内核的环境中。

2. 直接指定venv内的pip路径 #

先在Notebook单元格中运行以下代码，获取当前内核venv的Python路径：

import sys
print(sys.executable)

输出类似/path/to/your/venv/bin/python，将末尾的python替换成pip，即可得到venv内pip的完整路径。之后直接用该路径执行安装：

!/path/to/your/venv/bin/pip install pandas

3. 临时修改Notebook的PATH环境变量 #

在Notebook开头添加这段代码，把venv的bin目录放到PATH最前端：

import sys, os
venv_bin_dir = os.path.dirname(sys.executable)
os.environ['PATH'] = f"{venv_bin_dir}:{os.environ['PATH']}"

修改完成后，再运行!pip install pandas就会调用venv内的pip。注意这个修改仅对当前Notebook会话有效，重启Notebook后需要重新执行。

4. 永久修改内核的环境变量 #

找到你的venv内核配置文件（通常位于~/.local/share/jupyter/kernels/[你的内核名称]/kernel.json），编辑env字段，把venv的bin目录加到PATH最前面，同时设置VIRTUAL_ENV变量：

{
  "argv": [
    "/path/to/your/venv/bin/python",
    "-m",
    "ipykernel_launcher",
    "-f",
    "{connection_file}"
  ],
  "display_name": "Your Venv Kernel",
  "language": "python",
  "env": {
    "PATH": "/path/to/your/venv/bin:$PATH",
    "VIRTUAL_ENV": "/path/to/your/venv"
  }
}

保存后重启JupyterHub，后续启动该内核时，PATH会自动优先使用venv的工具，!pip和!python都会默认调用venv内的版本。

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