Jupyter nbconvert转幻灯片本地图片无法显示（403错误）咨询

我之前也踩过这个坑，这个403错误本质是Jupyter幻灯片服务器默认限制了访问当前工作目录以外的文件，加上图片路径解析逻辑的问题导致的。给你几个实用的解决办法，按优先级排序：

1. 调整图片路径为服务器根目录相对路径 #

如果你的幻灯片是通过jupyter nbconvert --to slides your_notebook.ipynb --serve启动的服务器访问的，Jupyter服务器的根目录默认是你执行命令时的当前工作目录。

比如原来的路径../assets/nn_basic_1.png是相对于Notebook文件的上级目录，但服务器只允许访问当前工作目录下的文件。你可以：

• 把图片路径改成相对于当前工作目录的路径：如果assets文件夹就在当前工作目录下，直接写成<img src="assets/nn_basic_1.png" width="50%" height="50%">
• 如果Notebook在子目录（比如notebooks/），assets在根目录，就用绝对路径（相对于服务器根）：<img src="/assets/nn_basic_1.png" width="50%" height="50%">

2. 启动服务器时指定允许访问的根目录 #

如果不想修改Notebook里的图片路径，可以在启动幻灯片服务器时，把根目录设置为包含assets文件夹的上级目录：

jupyter nbconvert --to slides your_notebook.ipynb --serve --ServePostProcessor.root_dir="../"

这里的../是指当前工作目录的上级目录，根据你的实际目录结构调整即可。这样服务器就会允许访问上级目录下的assets文件夹了。

3. 将图片内嵌到Notebook（无外部文件依赖） #

如果需要分发幻灯片，不想附带图片文件，可以把图片转成base64编码嵌入到Markdown里：

1. 在Notebook里添加一个代码单元格，运行以下代码：

import base64

def img_to_base64(img_path):
    with open(img_path, "rb") as f:
        return base64.b64encode(f.read()).decode("utf-8")

# 替换成你的图片路径
base64_str = img_to_base64("../assets/nn_basic_1.png")
print(f'<img src="data:image/png;base64,{base64_str}" width="50%" height="50%">')

2. 复制代码输出的完整<img>标签，替换原来Markdown单元格里的图片代码。这样转成幻灯片后，图片就内嵌在HTML里，不存在路径问题了。

4. 直接打开本地HTML的解决方案 #

如果你是直接双击打开转换后的HTML文件（不用服务器），浏览器的安全策略可能会阻止加载上级目录的文件。这时候：

• 把assets文件夹复制到和HTML文件同一目录，然后修改图片路径为assets/nn_basic_1.png
• 或者使用本地绝对路径（比如file:///Users/yourname/project/assets/nn_basic_1.png），但这种方式在不同机器上不可移植，不推荐。

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