Mac OS下Jupyter Notebook无法创建/打开笔记本求助

环境信息 #

• 系统：Mac OS
• Python版本：3.12.4
• Jupyter核心包版本：

Selected Jupyter core packages...
IPython          : 8.25.0
ipykernel        : 6.28.0
ipywidgets       : 7.8.1
jupyter_client   : 8.6.0
jupyter_core     : 5.7.2
jupyter_server   : 2.14.1
jupyterlab       : 4.0.11
nbclient         : 0.8.0
nbconvert        : 7.10.0
nbformat         : 5.9.2
notebook         : 7.0.8
qtconsole        : 5.5.1
traitlets        : 5.14.3

问题现象 #

• 网页端仪表盘能正常显示文件夹，但创建新笔记本无弹窗或打开动作
• 右上角「New」仅显示「notebook」选项（无Python内核选项）
• 选择「notebook」后，内核选择弹窗无响应
• 左上角打开按钮点击无效

排查与解决步骤 #

1. 重新注册Python内核 #

虽然ipykernel已安装，但可能未正确关联到当前Python环境。执行以下命令重新安装并注册内核：

pip install --upgrade ipykernel
python -m ipykernel install --user --name=python3.12 --display-name="Python 3.12"

完成后重启Jupyter Notebook，查看「New」菜单是否出现Python选项。

2. 清理Jupyter运行时缓存 #

Mac下Jupyter的运行时缓存可能导致异常，执行以下命令清理：

jupyter server stop
rm -rf ~/.jupyter/runtime/

重新启动Jupyter Notebook，测试创建/打开功能。

3. 检查浏览器兼容性 #

Notebook 7.x版本对旧浏览器兼容性较差，建议使用Chrome、Firefox或Safari最新版本。若使用Safari，可尝试开启开发模式禁用缓存：

• 打开Safari偏好设置 → 高级 → 勾选「在菜单栏中显示开发菜单」
• 开发菜单 → 勾选「禁用缓存」
  刷新Jupyter页面后重试。

4. 排查虚拟环境冲突（若使用虚拟环境） #

如果是在虚拟环境中安装的Jupyter，确认激活虚拟环境后再启动：

source 你的虚拟环境路径/bin/activate
jupyter notebook

同时检查虚拟环境内的ipykernel是否正确安装，避免全局环境与虚拟环境的包冲突。

5. 降级Notebook版本 #

Notebook 7.0.8可能与Python 3.12存在兼容性问题，尝试降级到稳定版本：

pip install notebook==6.5.6

降级后重启Jupyter，测试功能是否恢复正常。

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