jupyter无法识别新conda/virtualenv环境是因为未显式注册内核:需先激活目标环境,再pip install ipykernel,最后python -m ipykernel install --user --name myproject --display-name "python (myproject)"。

能切换,但必须在目标环境中装 ipykernel,且注册时名字不能重复——否则 Jupyter 里只显示一个内核,或者启动报错。
为什么 Jupyter 看不到你新创建的 conda/virtualenv 环境?
因为 Jupyter 不自动扫描所有 Python 环境,它只认“显式注册过”的内核。没装 ipykernel、没运行 python -m ipykernel install,那个环境就只是个普通 Python 解释器,Jupyter 根本不知道它存在。
- 常见错误现象:
KernelNotFoundError: No such kernel named python3(其实是找不到你自定义的名字)或列表里只有默认的python3 - conda 环境和 venv 环境处理方式一致,区别只在激活命令:
conda activate myenv或source myenv/bin/activate(macOS/Linux)/myenv\Scripts\activate(Windows) - 注册前务必先激活目标环境,否则装的是 base 环境的
ipykernel,注册的也是 base 的路径
怎么给指定环境安装并注册内核?
三步走:进环境 → 装包 → 注册,顺序不能错。
- 激活你的目标环境:
conda activate myproject或source venv/bin/activate - 安装
ipykernel:pip install ipykernel(conda 用户也可用conda install ipykernel,但 pip 更通用) - 注册为 Jupyter 内核:
python -m ipykernel install --user --name myproject --display-name "Python (myproject)"
说明:--name 是内核唯一标识(命令行切换用),--display-name 是 Jupyter UI 里看到的名字;--user 表示装到当前用户目录,避免权限问题;如果省略 --name,默认用 python3,多个环境会互相覆盖。
怎么在 Notebook 里切换内核?
两种方式,推荐用菜单操作,更直观可靠。
- 菜单栏操作:
Kernel → Change kernel → Python (myproject)(名字来自--display-name) - 命令行强制指定(适合脚本化):
jupyter notebook --NotebookApp.kernel_name=myproject,但这只影响新打开的 notebook,不改变已有文件绑定 - 注意:切换后需重启内核(
Kernel → Restart)才能生效,否则仍跑在旧解释器上,import sys; sys.executable可验证当前实际路径
删错内核或名字冲突了怎么办?
内核信息存在 JSON 文件里,直接删比重装干净。
- 查已注册内核位置:
jupyter kernelspec list,输出类似:myproject /Users/xxx/Library/Jupyter/kernels/myproject - 删除指定内核:
jupyter kernelspec uninstall myproject(--name值) - 常见坑:手动删目录不彻底,残留
kernel.json可能导致 Jupyter 启动失败;用uninstall命令最安全 - 重名注册会提示警告,但不会覆盖——除非加
--force,慎用
真正容易被忽略的是:内核注册后,Jupyter 并不实时监听变化。改了环境依赖(比如升级了 numpy),不用重新注册内核,但得重启 kernel 才能加载新版本模块。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











