Jupyter Notebook不会自动识别新Python环境，必须在激活目标环境并安装ipykernel后，执行python -m ipykernel install --user --name=py310 --display-name="Python 3.10"注册内核，且注册后需彻底重启Jupyter进程才能在Kernel菜单中显示并正确切换。
Jupyter Notebook 不会自动识别你新创建的 Python 环境，必须手动注册内核，否则 Kernel 菜单里永远只有默认项。
注册前确认目标环境已激活且 ipykernel 已安装
注册命令运行时，当前 shell 的 Python 解释器必须是你想暴露给 Jupyter 的那个。常见错误是：在 base 环境下执行 python -m ipykernel install，结果注册的是 base 的 Python，不是 py310 或 torch26_cpu。
- 先激活目标环境：
conda activate py310（conda）或source ~/pyenv/versions/3.10.12/bin/activate（pyenv） - 检查是否装了
ipykernel：python -m ipykernel --version；没输出就装：conda install ipykernel -y（conda 环境推荐）或pip install ipykernel - 别用系统别名（如
python3.10），要用绝对路径（which python3.10查）——仅适用于非 conda 环境
注册命令必须带 --user 且 --name 合法
--name 是内核在磁盘上的目录名，Jupyter 用它定位配置；非法字符会导致注册静默失败。
- 必须加
--user：避免权限问题，不加可能写入失败但终端无报错 -
--name只能含小写字母、数字、下划线，不能有空格、括号、中文（例如py310_cuda✅，py310 (cuda)❌） -
--display-name可自由命名（如"Python 3.10 + PyTorch 2.6"），只影响菜单显示 - 完整命令示例：
python -m ipykernel install --user --name=py310 --display-name="Python 3.10"
注册后必须彻底重启 Jupyter 进程
刷新网页、新建 tab、甚至 Kernel → Restart 都不会更新内核列表——Jupyter 启动时只读一次 jupyter kernelspec list 的结果。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
立即学习“Python免费学习笔记（深入）”；
- 先确认注册成功：
jupyter kernelspec list输出中必须出现你的--name（如py310） - 杀掉所有 Jupyter 进程：
ps aux | grep jupyter（macOS/Linux）或任务管理器（Windows） - 重新执行
jupyter notebook启动服务 - 如果仍不显示，大概率是旧内核残留：
jupyter kernelspec remove py310，再重装
切换后验证 sys.executable 是否匹配
右上角 Kernel 名称变了 ≠ 真切换成功。核心判断依据只有一个：sys.executable 输出路径是否指向目标环境的 Python 可执行文件。
- 在 Notebook 单元格中运行：
import sys; print(sys.executable) - 正确示例（Linux/macOS）：
/home/user/miniconda3/envs/py310/bin/python - 错误表现：路径仍是
/miniconda3/bin/python（base）或/usr/bin/python3（系统） - 修复顺序：Kernel → Interrupt → Kernel → Change kernel → 选目标 → 确认弹窗 → 再运行
print(sys.executable)
最容易被忽略的是：以为“重启 Kernel”等于“重载内核列表”，其实它只是清空变量；真正决定你能切到哪些内核的，是启动 Jupyter 时加载的那个快照。
