macOS环境下Jupyter Lab联动Voila失效的问题求助

问题根因 #

两个报错分别对应两类配置问题：

• 命令行调用Voila提示找不到base模板：Voila版本与nbconvert版本不兼容，高版本nbconvert重构了模板目录结构，旧版Voila无法匹配到默认base模板路径
• Jupyter Lab内访问/lab/voila路径404：仅安装了Voila的服务端扩展，未安装Jupyter Lab对应的Voila前端预览扩展，Lab前端无法识别Voila相关路由

修复步骤 #

• 先卸载现有存在兼容问题的相关包

pip3 uninstall -y voila nbconvert jupyterlab

• 安装经兼容性验证的版本组合，该版本组合会自动安装Voila对应的Jupyter Lab前端扩展，无需额外手动配置

pip3 install jupyterlab==3.6.7 nbconvert==6.5.4 voila==0.4.1

• 校验扩展启用状态
  执行jupyter serverextension list，确认返回结果中voila条目状态为enabled
  执行jupyter labextension list，确认返回结果中存在@voila-dashboards/jupyterlab-preview条目且状态为enabled

符合需求的Voila唤起方式 #

不需要在代码末尾追加Voila调用命令，安装完成后直接通过以下两种方式唤起即可：

• 同页面渲染：打开目标ipynb文件，点击顶部工具栏的火箭图标，选择「Render with Voila」，即可在当前Jupyter Lab标签页内直接渲染无代码、仅保留交互组件和输出结果的仪表盘
• 独立结果页：启动Jupyter Lab后，不要访问/lab/voila路径，直接访问根路由下的/voila路径，即可打开无编辑界面、仅保留交互操作按钮的独立结果页面，点击对应notebook文件即可查看渲染结果

注意事项 #

不要将nbconvert升级到7.x及以上版本，该版本重构了模板存储结构，目前0.4.x版本的Voila暂不兼容，升级后会再次触发base模板找不到的报错，可通过pip3 install nbconvert==6.5.4命令锁定版本。

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