Jupyter不会自动识别conda新环境，必须手动注册内核：先激活目标环境，再安装ipykernel，最后执行python -m ipykernel install --user --name=xxx --display-name="xxx"，且注册后需重启Jupyter进程。
为什么新conda环境在Jupyter里根本看不到
Jupyter Notebook 不会自动扫描系统里所有 Python 解释器，它只认“注册过”的内核。哪怕你刚用 conda create -n py310 python=3.10 创建完环境，只要没执行 python -m ipykernel install，这个环境就不会出现在 Kernel 下拉菜单里。
常见错误现象包括：jupyter kernelspec list 输出里压根没有你的环境名；Kernel 菜单里只有 Python 3 或 Python (base)；误以为 conda activate myenv 后再启动 jupyter notebook 就能自动生效——其实不会。
注册内核必须按顺序执行这三步
顺序错一步，注册的就是当前 shell 的 Python，不是你想要的环境：
- 先激活目标环境：
conda activate py310或source venv/bin/activate - 再安装
ipykernel：pip install ipykernel（conda install ipykernel也可，但 pip 更通用） - 最后注册内核：
python -m ipykernel install --user --name=py310 --display-name="Python 3.10"
--name 是内核唯一标识（路径名），必须纯英文+下划线，不能含空格或括号；--display-name 是界面上显示的名字，可加中文说明；务必带 --user，避免权限问题；--name 不能重复，否则旧内核会被覆盖。
立即学习“Python免费学习笔记（深入）”；
切换后 import 失败？先验证是不是真切对了
切换 Kernel 后不重启内核，import 仍走旧解释器。正确验证方式是运行：
import sys; print(sys.executable)
输出路径必须和目标环境一致，比如 ~/miniconda3/envs/py310/bin/python。如果不对：
- 点击
Kernel → Interrupt，再Kernel → Change kernel重新选一次，别跳过“确认重启”弹窗 - 仍不行就删掉重装：
jupyter kernelspec remove py310，再走一遍注册流程 - 注册完必须重启整个 Jupyter Notebook 进程（关掉浏览器标签 + 终端
Ctrl+C再jupyter notebook），否则新内核不加载
PyCharm 或 Jupyter Lab 里切换逻辑一样吗
底层机制完全一致：都是靠 jupyter kernelspec 管理的同一套内核列表。PyCharm 右上角“托管服务 → 切换内核”、Jupyter Lab 右上角 Kernel 菜单，背后都读取 jupyter kernelspec list 的结果。唯一区别是：PyCharm 有时缓存较顽固，添加新内核后建议重启 PyCharm；Jupyter Lab 不需要重启应用本身，但新内核注册后仍需刷新页面或重启 Lab 进程才能识别。
最容易被忽略的一点：注册命令必须在目标环境中运行，且 --name 值一旦写错（比如拼错、含空格），后续就只能删掉重来——Jupyter 不允许覆盖同名内核，也不会报明确错误，只会静默失败。
