解决 Anaconda 安装 nb_conda_kernels 后 Jupyter Lab 启动报错且无法安装插件的问题

1. 问题

• 问题1
• Config option kernel_spec_manager_class not recognized by LabApp.
• Config option kernel_spec_manager_class not recognized by NotebookApp.

这是安装 nb_conda_kernels 后，启动 Jupter Lab 时出现的问题

• 问题2
• Config option kernel_spec_manager_class not recognized by InstallLabExtensionApp.

这是进入 Jupyter Lab 后，安装插件时遇到的问题

2. 原因分析

根据 jupyter/notebook 项目中 Issues 中的一篇帖子 kernel_spec_manager_class not recognized Issue #5855。导致问题出现的原因是，NotebookApp.kernel_spec_manager_class 默认会调用 jupyter_client.kernelspec.KernelSpecManager，nb_conda_kernels 安装后修改了 jupyter_client.kernelspec.KernelSpecManager 的默认设置。

以上情况是 Jupyter Notebook 中的情况，在 Jupyter Lab 中原因是一样的，只是名称有所不同。

在 Jupyter Lab中，是 c.ServerApp.kernel_spec_manager_class 调用 jupyter_client.kernelspec.KernelSpecManager，因此 nb_conda_kernels 安装后修改的是 jupyter_client.kernelspec.KernelSpecManager，的默认设置。

• Jupyter Lab 生成配置文件的命令为：

jupyter lab --generate-config

3. 解决方案

按照前面的分析，问题处理的思路十分简单，只要将 jupyter_client.kernelspec.KernelSpecManager 重新设置即可。

• 3.1 查找 jupyter_client.kernelspec.KernelSpecManager 配置文件的路径

 jupyter trust --debug

• 3.2 修改找到的配置文件

修改前

修改后

{
  "CondaKernelSpecManager": {
    "kernelspec_path": "--user",
    "name_format": "{kernel} ({environment})"
  }
}

4. 效果

• 4.1 启动效果
  

• 4.2 安装插件效果
  

• 4.3 多环境呈现效果
  

参考文献

[1] kernel_spec_manager_class not recognized Issue
[2] 关于jupyter notebook启动时一些报错
[3] Conda environments in Jupyter ecosystem without pain