多Pipenv项目下Jupyter自动匹配对应内核的方法问询

方案1：本地内核映射（推荐） #

无需全局注册内核，直接在项目目录下创建专属内核配置，Jupyter打开该目录时会优先识别本地内核，且仅当前项目可见：

• 进入项目根目录，创建内核配置目录：

  mkdir -p .ipython/kernels/$(basename $(pwd))
  

• 生成kernel.json文件，替换其中的Python路径为当前Pipenv虚拟环境的Python路径（可通过pipenv run which python获取）：

  {
   "argv": [
    "/path/to/your/project/venv/bin/python",
    "-m",
    "ipykernel_launcher",
    "-f",
    "{connection_file}"
   ],
   "display_name": "Pipenv: $(basename $(pwd))",
   "language": "python"
  }
  

• 完成后，打开项目内的Notebook，Jupyter会自动显示该项目的专属内核选项。

方案2：Pipenv钩子自动生成本地内核 #

在项目Pipfile中添加安装后钩子，每次执行pipenv install或pipenv sync时自动生成本地内核配置：
在Pipfile的[scripts]区块下添加：

[scripts]
post_install = """
mkdir -p .ipython/kernels/$(basename $(pwd)) && \
echo '{
 "argv": [
  "'$(pipenv run which python)'",
  "-m",
  "ipykernel_launcher",
  "-f",
  "{connection_file}"
 ],
 "display_name": "Pipenv: $(basename $(pwd))",
 "language": "python"
}' > .ipython/kernels/$(basename $(pwd))/kernel.json
"""

方案3：全局Jupyter配置自动匹配Pipenv环境 #

修改Jupyter全局配置，让它自动检测当前目录的Pipenv虚拟环境并生成临时内核：

1. 生成Jupyter配置文件（若未生成过）：

   jupyter notebook --generate-config
   

2. 打开~/.jupyter/jupyter_notebook_config.py，添加以下代码：

   import os
   from pathlib import Path
   
   def find_pipenv_python():
       current_dir = Path.cwd()
       # 向上查找最近的Pipfile
       for parent in [current_dir] + list(current_dir.parents):
           pipfile = parent / "Pipfile"
           if pipfile.exists():
               import subprocess
               try:
                   result = subprocess.run(
                       ["pipenv", "run", "which", "python"],
                       capture_output=True,
                       text=True,
                       cwd=str(parent)
                   )
                   return result.stdout.strip()
               except:
                   pass
       return None
   
   # 优先使用本地内核，关闭全局内核白名单限制
   c.KernelSpecManager.prefer_local_kernel = True
   
   # 重写内核获取逻辑，自动添加当前Pipenv环境内核
   from jupyter_client.kernelspec import KernelSpecManager
   original_get_specs = KernelSpecManager.get_all_specs
   
   def custom_get_specs(self):
       specs = original_get_specs(self)
       pipenv_python = find_pipenv_python()
       if pipenv_python:
           project_name = Path.cwd().name
           spec_name = f"pipenv-{project_name}"
           specs[spec_name] = {
               "argv": [pipenv_python, "-m", "ipykernel_launcher", "-f", "{connection_file}"],
               "display_name": f"Pipenv: {project_name}",
               "language": "python"
           }
       return specs
   
   KernelSpecManager.get_all_specs = custom_get_specs
   

之后打开Jupyter时，会自动检测当前目录的Pipenv环境并生成对应内核选项，不会污染全局内核列表。

额外清理建议 #

• 查看所有全局注册的内核：jupyter kernelspec list
• 删除不需要的旧内核：jupyter kernelspec remove [内核名称]

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