根本原因是jupyter只识别已注册的内核，虚拟环境需在激活状态下安装ipykernel并执行python -m ipykernel install --user --name myenv --display-name "python (myenv)"才能被kernelspec list显示。
为什么 jupyter kernelspec list 看不到你的虚拟环境
根本原因：Jupyter 不会自动发现你用 python -m venv 或 conda create 创建的虚拟环境，它只认“已注册为内核”的环境。没手动安装 ipykernel 并执行注册，Jupyter 就完全不知道那个环境的存在。
常见错误现象：jupyter kernelspec list 输出里只有 python3（系统默认）或旧的内核名，新 venv 名字压根不出现；Notebook 右上角 Kernel → Change kernel 菜单里也找不到对应选项。
- 必须在目标虚拟环境中运行
python -m ipykernel install，不是在 base 环境或系统 Python 里执行 - 如果虚拟环境没激活，
pip install ipykernel会装到错的地方，后续注册必然失败 - Windows 下路径含空格（如
C:\Users\John Doe\...）可能引发注册异常，建议用短路径或改用户名
如何正确注册一个 venv 到 Jupyter（含命名与用户级安装）
注册本质是把当前 Python 解释器路径、启动参数、显示名称写进 kernelspec 目录。关键在于控制 --user 和 --name 参数。
实操步骤（以 myenv 为例）：
- 终端中激活环境：
source myenv/bin/activate（macOS/Linux）或myenv\Scripts\activate（Windows） - 确保
ipykernel已安装：pip install ipykernel（若提示已存在可跳过） - 注册内核并指定显示名：
python -m ipykernel install --user --name myenv --display-name "Python (myenv)"
--user 表示内核注册到当前用户目录（避免权限问题），--name 是内核唯一标识（用于删除或切换），--display-name 是 Notebook 界面里看到的名字。不加 --display-name 时，默认显示为 Python (myenv)，但显式指定更可控。
如何在 Notebook 里切换到刚注册的内核
注册成功后无需重启 Jupyter，但需刷新或新建 Notebook 才能生效。
- 已有 Notebook：Kernel → Change kernel → 选择你设的
--display-name（如Python (myenv)） - 确认是否生效：执行
import sys; print(sys.executable)，输出路径应指向你的myenv/bin/python（或myenv\Scripts\python.exe） - 如果切换后仍报
ModuleNotFoundError，说明代码实际还在跑旧内核——检查右上角 Kernel 名称是否真的变了，有时 UI 滞后，可尝试 Kernel → Restart & Run All
注意：Kernel → Interrupt 不会改变内核，只是停掉当前执行；真正切换必须走 Change kernel 流程。
删错内核或重名了怎么办
内核注册信息存在用户目录下，误注册或重名会导致 Notebook 列表混乱、切换失败甚至启动报错。
查位置：jupyter kernelspec list 会显示每个内核对应的绝对路径（如 /Users/xxx/Library/Jupyter/kernels/myenv）
- 安全删除：
jupyter kernelspec uninstall myenv（--name值，不是 display-name） - 强制覆盖重装：先卸载，再用原命令重新
install；不要直接手动删文件夹，可能残留 JSON 配置引用 - conda 环境同理：激活 conda env 后同样走
python -m ipykernel install --user --name xxx，Jupyter 对 conda 和 venv 无区别对待，只看python可执行路径
容易被忽略的是：多个项目共用同一个 --name（比如都叫 py39），会导致后注册的覆盖前一个，看似切换成功，实际运行的是另一个环境的解释器。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
