尝试升级Python版本后Jupyter Notebook卡顿故障求助

第一步：彻底清理混乱的Jupyter环境 #

先移除所有可能导致版本冲突的残留文件和包：

• 卸载所有关联的Jupyter组件：

  # 卸载当前python3绑定的jupyter相关包
  pip3 uninstall -y jupyter jupyter_core jupyter_client ipython ipykernel
  # 若之前用brew安装过Jupyter，一并卸载
  brew uninstall --force jupyter
  

• 删除Jupyter的配置、缓存文件：

  rm -rf ~/.jupyter
  rm -rf ~/.local/share/jupyter
  rm -rf ~/.cache/jupyter
  

第二步：基于Python 3.12.0重新安装Jupyter #

先确认目标Python版本路径，确保操作完全基于3.12：

# 验证Python 3.12路径（根据你的实际安装路径调整）
/usr/local/bin/python3.12 --version

执行安装命令：

# 更新对应版本的pip
/usr/local/bin/python3.12 -m pip install --upgrade pip
# 安装Jupyter核心组件
/usr/local/bin/python3.12 -m pip install jupyter ipykernel

第三步：注册Python 3.12为Jupyter默认内核 #

将3.12版本添加到Jupyter内核列表，并清理旧内核：

# 注册Python 3.12内核
/usr/local/bin/python3.12 -m ipykernel install --user --name=python3.12 --display-name="Python 3.12"
# 查看现有内核列表，确认3.12已加入
jupyter kernelspec list
# 移除旧的Python 3.7内核（可选，避免后续误选）
jupyter kernelspec remove python3.7

第四步：验证修复效果 #

启动Jupyter Notebook检查状态：

jupyter notebook

• 启动时应无date_default弃用警告
• 创建新笔记本选择Python 3.12内核，不会出现卡顿，控制台无RuntimeError报错
• 在笔记本中运行以下代码，确认版本匹配：

  import sys
  print(sys.version)
  

额外提示 #

• 始终用pythonX.X -m pip的方式安装包，避免不同Python版本的pip混用导致依赖混乱
• 若使用pyenv管理Python版本，需先激活3.12环境再执行安装命令：

  pyenv activate 3.12.0
  pip install jupyter ipykernel
  

内容的提问来源于stack exchange，提问作者Ari