JupyterLab中用RISE渲染笔记本为Reveal幻灯片遇404错误

开发者阿泽

2026-7-20

解决RISE在JupyterLab中启动幻灯片时的404错误

以下是针对你遇到问题的排查和解决步骤：

确认RISE与JupyterLab版本兼容
不同版本的JupyterLab对RISE的兼容性要求不同。先查看当前JupyterLab版本：
```
jupyter lab --version
```
若版本不匹配，卸载现有RISE并重装适配版本：
```
pip uninstall -y rise
# 针对JupyterLab 3.x+可直接安装最新稳定版
pip install rise
```
若使用conda环境，改用conda命令：
```
conda remove rise
conda install -c conda-forge rise
```
检查RISE扩展是否正确启用
运行以下命令查看JupyterLab扩展状态：
```
jupyter labextension list
```
确认@jupyterlab/rise扩展状态为enabled。若未启用，执行：
```
jupyter labextension install @jupyterlab/rise
```
完成后重启JupyterLab。

清理JupyterLab缓存
缓存损坏可能导致资源路径错误，执行清理命令后重启JupyterLab：

jupyter lab clean
# JupyterLab 3.x+无需执行build命令，2.x及以下版本需添加：jupyter lab build

配置Reveal.js资源路径
RISE依赖Reveal.js资源，若本地路径识别异常，可在笔记本元数据中指定CDN路径：
1. 打开笔记本，点击右上角Settings → Advanced Settings Editor
2. 选择RISE选项卡，在User Preferences中添加：
```
{
  "reveal_js_url": "https://cdn.jsdelivr.net/npm/reveal.js@4.3.1"
}
```
保存后重启笔记本再尝试渲染。
排除Sagemath内核的环境冲突
切换到默认Python内核，点击"Render notebook"测试是否仍报错：
- 若切换后正常，说明问题出在Sagemath环境中。需确保RISE安装在Sagemath对应的conda/虚拟环境内，而非全局环境。激活Sagemath环境后重新安装RISE即可。