内核状态为灰色圆点且代码无响应，说明内核已断开或假死，应直接选择kernel → restart，待右上角变白色并显示“kernel ready”后，运行print("ok")验证；interrupt通常失效，反复点击运行或仅重启浏览器无效。
内核状态是灰色圆点，代码单元格点击后无响应
这说明内核已断开或假死，不是浏览器卡顿也不是代码慢——它根本没收到执行指令。右上角显示灰色圆点（Kernel dead 或 Kernel disconnected）时，Interrupt 按钮通常已失效，直接点 Restart 是最快路径。
操作顺序必须是：Kernel → Restart，等右上角变回白色圆点、提示 Kernel ready 后，再运行一个 print("ok") 测试。别急着重跑原代码，避免残留状态干扰验证。
常见误操作：
- 反复点击运行按钮，但内核没恢复，只是堆积 pending 请求
- 在灰色状态下强行
Interrupt，多数时候无响应，浪费时间 - 重启浏览器却不重启 Jupyter 进程，旧内核进程可能仍在后台僵死
启动后界面空白，或跳转到 token/password 输入页
这不是内核问题，而是浏览器缓存或 cookie 损坏导致的会话中断。尤其常见于异常关闭（如 kill 进程、断电、强制关机）后再次打开 Notebook。
临时解决办法很简单：清空当前域名（localhost:8888 或对应端口）下的所有 cookie 和站点数据，然后刷新页面。不用改配置、不用重装。
如果每次重启都重现，说明浏览器自动保存了损坏的 session，建议：
- 换一个浏览器首次登录（比如 Chrome 换 Edge），确认是否复现
- 检查系统用户名是否含中文（如
C:\Users\张三），Windows 下这会导致%USERPROFILE%路径解析失败，临时改用%systemroot%\TEMP替代环境变量中的临时目录路径
终端报错 zmq 相关异常或 tornado 版本冲突
典型错误信息包括：AttributeError: module 'zmq' has no attribute 'Context'、RuntimeError: Cannot run in multiple threads，或启动时卡在 Serving notebooks... 不出页面。大概率是 pyzmq 或 tornado 版本与当前 ipykernel 不兼容。
优先验证并修复：
- 运行
pip show pyzmq tornado ipykernel，确认版本组合。2026 年主流稳定组合是：pyzmq==24.0.1+tornado==6.3.3+ipykernel==6.27.0 - 若
pyzmq>25.x，先执行pip uninstall pyzmq -y && pip install pyzmq==24.0.1 - 若
tornado≥7.0，降级：pip install tornado==6.3.3（注意：tornado 7+ 移除了部分 Jupyter 依赖的 API）
改完记得重启整个 Jupyter 进程（Ctrl+C 停掉服务，再 jupyter notebook 重起），只重启内核无效。
内核重启后立刻报 Kernel died，或选不到环境
说明内核注册信息损坏或 Python 解释器路径失效。此时 Kernel → Change kernel 下拉列表为空，或点了之后立刻灰掉。
关键动作是重建内核规范：
- 激活目标环境（conda 或 venv），例如
conda activate myenv - 重装
ipykernel：python -m pip uninstall ipykernel -y && python -m pip install ipykernel - 重新注册：
python -m ipykernel install --user --name=myenv --display-name="Python (myenv)" - 检查
kernel.json是否指向真实路径：运行jupyter kernelspec list找到路径，打开对应目录下的kernel.json，确认"argv"第一项是当前环境中python的绝对路径（比如/home/user/myenv/bin/python，不是python或python3）
路径写错是最隐蔽也最常见的原因——哪怕只差一个字符，内核也会静默退出，不报错，只显示 Kernel died。
