解决jupyter_nbextensions_configurator与jupyter_lsp加载失败问题

问题概述 #

通过Conda创建基础环境，使用pip安装JupyterLab及相关依赖后，启动时出现两个核心问题，同时伴随配置迁移警告：

• jupyter_nbextensions_configurator组件未主动安装，但被尝试加载导致失败
• jupyter_lsp因权限问题无法访问.virtual_documents文件夹，加载失败
• 多个配置项从NotebookApp迁移到ServerApp的警告

具体问题分析 #

1. jupyter_nbextensions_configurator加载失败：该组件未在当前环境安装，但Jupyter配置中仍标记为启用，导致启动时触发找不到模块的错误。大概率是全局Jupyter配置中遗留了该扩展的启用记录，被当前Conda环境继承。
2. jupyter_lsp权限错误：jupyter_lsp启动时需要清理.virtual_documents文件夹，但该文件夹所在的A:\My Documents目录权限受限，即使文件夹标记为只读，删除操作仍需要更高权限，而Notebook checkpoint文件夹仅需写入权限，因此可以正常工作。

问题解决步骤 #

一、解决jupyter_nbextensions_configurator加载失败 #

1. 定位Jupyter配置目录
   激活Conda环境后执行：

   jupyter --config-dir
   

   输出路径即为当前环境和全局配置的读取位置（如C:\Users\Julian\.jupyter）。

2. 禁用该扩展

   • 方法一：命令行直接禁用

     jupyter server extension disable jupyter_nbextensions_configurator
     

   • 方法二：手动修改配置文件
     打开配置目录下的jupyter_server_config.json或jupyter_notebook_config.json，找到enabled_extensions或相关条目，将jupyter_nbextensions_configurator移除，或设置为false。

二、解决jupyter_lsp权限问题 #

方案1：手动清理受限文件夹

以管理员权限打开终端，执行以下命令删除目标文件夹：

rmdir /s /q "A:\My Documents\.virtual_documents"

删除后重新启动JupyterLab，jupyter_lsp会自动重建该文件夹（若权限允许）。

方案2：修改虚拟文档存储路径

将虚拟文档文件夹迁移到有完整读写权限的位置：

1. 创建新的存储文件夹，比如C:\Users\Julian\.jupyter\virtual_documents
2. 修改Jupyter配置：
   • 生成配置文件（若未存在）：

     jupyter server --generate-config
     

   • 打开生成的jupyter_server_config.py，添加以下配置：

     c.JupyterLSP.virtual_documents_uri = "file:///C:/Users/Julian/.jupyter/virtual_documents"
     

3. 保存配置后重启JupyterLab即可。

三、解决配置迁移警告 #

针对notebook_dir、password_required、token等配置项的迁移警告，按以下步骤更新：

1. 打开jupyter_server_config.py配置文件
2. 将原有的NotebookApp相关配置替换为ServerApp：
   • 原c.NotebookApp.notebook_dir = "A:\My Documents" → 改为c.ServerApp.root_dir = "A:\My Documents"
   • 原c.NotebookApp.password_required = True/False → 改为c.ServerApp.password_required = True/False
   • 原c.NotebookApp.token = "xxx" → 改为c.ServerApp.token = "xxx"
3. 保存配置后重启JupyterLab，警告将消失。

防止问题复发的措施 #

• 创建Conda环境时添加--no-default-packages参数，避免继承全局环境的包和配置：

  conda create --name PYTFCurrent --no-default-packages python=3.10.6
  

• 优先使用Conda安装Jupyter相关组件，减少pip与Conda的依赖冲突：

  conda install jupyterlab jupyterlab-lsp
  

• 定期清理全局Jupyter配置目录，移除未使用的扩展启用条目
• 避免将JupyterLab的工作目录设置为系统权限受限的文件夹（如My Documents），选择自定义的有完整读写权限的目录

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