Quarto博客中Manim动画渲染失败问题求助

DevOps 小满

2026-7-25

解决Quarto中Manim动画404无法显示的问题

以下是针对路径配置问题的几种可行解决方法：

手动指定Manim输出到Quarto默认媒体目录
Manim默认生成的media文件夹不在Quarto的默认媒体搜索范围内，直接修改Manim的配置，把输出目录改成Quarto的_media文件夹：
```
from manim import *

# 强制输出到Quarto默认媒体目录
config.media_dir = "_media"
config.renderer = "jupyter"  # 保持和Notebook一致的渲染逻辑

class TestScene(Scene):
    def construct(self):
        self.play(Write(Text("Hello Quarto + Manim")))
```
这样渲染后视频会直接出现在_media里，Quarto能正确识别路径。
修改Quarto配置识别Manim的media目录
不想改代码的话，在项目根目录的_quarto.yml里添加媒体目录配置，让Quarto扫描Manim默认的media文件夹：
```
project:
  type: website

website:
  media: ["media"]  # 把Manim的media目录加入Quarto的媒体搜索列表
```
保存后重新渲染Quarto，就能找到视频文件了。
锁定Quarto渲染的工作目录
有时候Quarto渲染时的工作目录和你运行Notebook的目录不一样，导致相对路径出错。在qmd文件的YAML头部指定工作目录：
```
---
title: "Manim Animation Demo"
execute:
  working-dir: "."  # 强制使用当前qmd所在的目录作为工作目录
---
```
强制Manim生成相对路径引用
调整Manim的媒体文件路径配置，确保生成的视频引用是相对路径：
```
config.media_file_path = "./media/videos/{module_name}/{quality}/{scene_name}.mp4"
```
这样HTML里的视频链接会是相对路径，避免绝对路径导致的404问题。