Jupyter Notebook打开缓慢且扩展不显示：[MathJax]相关问题

问题根因说明 #

你遇到的加载卡慢、扩展不显示问题，核心原因通常是用户目录下的nbextensions配置损坏，以及MathJax默认调用公共CDN资源网络不稳定导致，重装Jupyter不会默认清除用户自定义配置，因此之前的重装操作无效。

修复步骤 #

1. 重置损坏的扩展配置 #

• 先关闭所有运行中的Jupyter进程，执行以下命令清理旧配置：

  # 禁用旧的扩展配置
  jupyter nbextensions_configurator disable --user
  # 删除配置文件目录（Linux/macOS）
  rm -rf ~/.jupyter/nbconfig
  rm -rf ~/.local/share/jupyter/nbextensions
  

  Windows系统可手动删除以下两个目录：

  • C:\Users\你的用户名\.jupyter\nbconfig
  • C:\Users\你的用户名\AppData\Roaming\jupyter\nbextensions

• 重新安装nbextensions扩展包：

  pip install jupyter_contrib_nbextensions
  jupyter contrib nbextension install --user
  jupyter nbextensions_configurator enable --user
  

2. 解决MathJax加载慢问题 #

默认配置下Jupyter会调用公共CDN的MathJax资源，网络波动会导致加载卡慢，可切换为本地资源：

• 安装本地MathJax包：

  pip install jupyter_mathjax
  jupyter nbextension enable --py jupyter_mathjax
  

• 也可直接修改Jupyter配置实现，先执行jupyter notebook --generate-config生成默认配置文件，再在~/.jupyter/jupyter_notebook_config.py中添加以下配置：

  c.NotebookApp.mathjax_url = '/static/components/MathJax/MathJax.js'
  

3. 单个文件异常修复 #

如果仅特定ipynb文件出现该问题，执行nbstripout无效后可新建空白笔记本，将原文件的代码、markdown单元逐块复制到新文件中保存即可，排除文件内嵌的异常元数据导致的加载问题。

验证 #

重启Jupyter Notebook后重新打开文件，确认MathJax加载提示消失、目录等扩展正常显示即可。

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