Conda更新后Jupyter nbextensions加载错误的解决方法求助

问题描述 #

• 更新Conda环境及包后，多次卸载重装导致大部分nbextensions访问权限丢失
• 重新安装Miniconda+Jupyter+jupyter_contrib_nbextensions并启用nbextensions_configurator后，进入配置器标签所有扩展报错，命令行提示路径缺失或版本冲突
• 报错信息：[jupyter_nbextensions_configurator] error loading <extension>/<path>

已尝试操作 #

conda install -c conda-forge jupyter_contrib_nbextensions
jupyter contrib nbextension install --user
jupyter nbextensions_configurator enable --user

当前环境信息 #

Jupyter核心包版本 #

IPython          : 8.12.0
ipykernel        : 6.19.2
ipywidgets       : 8.0.4
jupyter_client   : 8.1.0
jupyter_core     : 5.3.0
jupyter_server   : 1.23.4
jupyterlab       : 3.5.3
nbclient         : 0.5.13
nbconvert        : 6.5.4
nbformat         : 5.7.0
notebook         : 6.5.4
qtconsole        : 5.4.2
traitlets        : 5.7.1

Conda信息 #

(base) PS C:\Users\_me_> conda info
     active environment : base
    active env location : C:\Users\_me_\miniconda3
            shell level : 1
       user config file : C:\Users\_me_\.condarc
 populated config files : C:\Users\_me_\.condarc
          conda version : 23.3.1
    conda-build version : not installed
         python version : 3.8.16.final.0
       virtual packages : __archspec=1=x86_64
                          __cuda=11.0=0
                          __win=0=0
       base environment : C:\Users\_me_\miniconda3  (writable)
      conda av data dir : C:\Users\_me_\miniconda3\etc\conda
  conda av metadata url : None
           channel URLs : https://repo.anaconda.com/pkgs/main/win-64
                          https://repo.anaconda.com/pkgs/main/noarch
                          https://repo.anaconda.com/pkgs/r/win-64
                          https://repo.anaconda.com/pkgs/r/noarch
                          https://repo.anaconda.com/pkgs/msys2/win-64
                          https://repo.anaconda.com/pkgs/msys2/noarch
          package cache : C:\Users\_me_\miniconda3\pkgs
                          C:\Users\_me_\.conda\pkgs
                          C:\Users\_me_\AppData\Local\conda\conda\pkgs
       envs directories : C:\Users\_me_\miniconda3\envs
                          C:\Users\_me_\.conda\envs
                          C:\Users\_me_\AppData\Local\conda\conda\envs
               platform : win-64
             user-agent : conda/23.3.1 requests/2.28.1 CPython/3.8.16 Windows/10 Windows/10.0.22621 solver/libmamba conda-libmamba-solver/23.3.0 libmambapy/1.4.1
          administrator : False
             netrc file : None
           offline mode : False

解决方案 #

1. 彻底清理残留配置文件 #

• 关闭所有Jupyter相关进程
• 删除用户目录下的Jupyter配置文件夹：C:\Users\_me_\.jupyter
• 删除用户目录下的nbextensions缓存：C:\Users\_me_\AppData\Roaming\jupyter\nbextensions

2. 创建全新Conda环境隔离版本冲突 #

# 创建指定Python版本的新环境
conda create -n jupyter-nbext python=3.9 -y
conda activate jupyter-nbext

# 安装兼容版本的Jupyter和nbextensions
conda install -c conda-forge notebook=6.5.4 jupyter_contrib_nbextensions jupyter_nbextensions_configurator -y

# 初始化配置
jupyter contrib nbextension install --user
jupyter nbextensions_configurator enable --user

3. 验证扩展加载 #

启动Jupyter Notebook，进入Nbextensions标签，检查扩展是否正常加载。若仍有问题，执行以下命令查看详细日志：

jupyter notebook --debug

根据日志中的具体路径错误，手动确认扩展文件是否存在，若缺失可重新安装对应扩展包。

4. 版本兼容性说明 #

• jupyter_contrib_nbextensions对Notebook 6.x版本兼容性较好，Notebook 7+已转向JupyterLab扩展生态
• 避免混合使用conda和pip安装Jupyter相关包，防止依赖冲突

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