Jupyter Notebook不会自动识别新conda环境，必须用ipykernel手动注册内核：先激活目标环境，再安装ipykernel，最后执行python -m ipykernel install --user --name=xxx --display-name="xxx"；注册后需重启Jupyter进程，否则内核不显示。
直接说结论：Jupyter Notebook 不会自动识别你新装的 Python 版本或 conda 环境，必须手动用 ipykernel 注册——否则你在终端里能跑 python3.10，Notebook 里还是显示 Python 3.8 (default)。
为什么新环境在 Jupyter 里根本看不到？
因为 Jupyter 的内核列表和系统/conda 环境是解耦的。它只认注册过的内核，不认“存在”的 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就自动生效（其实不会）
注册内核时 --name 和 --display-name 到底怎么填？
--name 是内核在文件系统里的唯一标识符（路径名），--display-name 是你在 Notebook 界面里看到的名称。两者可以不同，但建议保持一致，避免混淆。
立即学习“Python免费学习笔记（深入）”；
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
实操建议：
-
--name用纯英文+下划线，不含空格或括号，比如py310_cuda、torch26_cpu -
--display-name可加中文或说明性文字，比如"Python 3.10 + CUDA 12.1"、"PyTorch 2.6 (CPU-only)" - 务必加
--user参数，避免权限问题；不要用--system，除非你明确要全局安装 - 注册命令必须在目标环境激活状态下运行，否则注册的是当前 shell 的 Python，不是你想要的环境
切换后 import 失败或 sys.executable 指向旧路径？
这说明内核没真正切换成功，或者 Notebook 缓存了旧内核状态。不是代码问题，是环境绑定问题。
验证和修复步骤：
- 先在 Notebook 单元格中运行：
import sys; print(sys.executable)—— 输出路径必须和你目标环境的python路径一致（比如~/miniconda3/envs/py310/bin/python） - 如果不对，点击
Kernel → Interrupt，再Kernel → Change Kernel重新选一次，别跳过“确认重启”弹窗 - 仍不行？执行
jupyter kernelspec remove <name></name>删除旧注册，重新走一遍安装+注册流程 - 注意：切换内核后所有变量丢失，不需要保存再重开，直接换就行
最容易被忽略的一点：注册完内核后，必须重启 Jupyter Notebook 进程本身（不是刷新网页），否则新内核不会加载进服务端列表。很多用户卡在这一步，反复注册却始终看不到新选项。
