资料整理

No module named av：装了 FFmpeg，为什么 Python 还是找不到？

分别检查 PyAV 的 Python 入口、其使用的多媒体库，以及节点调用的外部 FFmpeg 程序。

更新于 2026-09-25发布修订: 7资料基线: 7

现象与适用范围

No module named 'av'、原生库导入失败、外部 ffmpeg 命令报错和媒体解码失败属于不同阶段。先确定报错来自哪条调用路径，再改依赖。

已核对的依据

当前 PyAV 安装指南所述 18.1.0 版本要求 Python 3.11 或更新。其 Linux、macOS、Windows 二进制 wheel 随包提供 FFmpeg 库；若用自己的 FFmpeg 从源码构建 PyAV，则另需对应的开发库和工具。PyAV 在 Python 中以 av 导入，提供容器和帧接口。FFmpeg 命令行程序是独立可执行文件。只安装该程序不会自动安装 Python 绑定；能导入 PyAV wheel 也不证明节点能启动外部命令。

需要区分的情况

1. 启动 ComfyUI 的解释器找不到 av，或所选 PyAV 发行版没有适合该解释器、平台的 wheel。

2. av 已安装，但原生扩展或 FFmpeg 库加载失败。源码构建失败和二进制 wheel 导入失败的先决条件不同。

3. 节点启动的外部 ffmpeg/ffprobe 程序缺失，或找到的不是预期可执行文件。

4. Python 导入与命令查找都正常，但特定容器、编解码器、轨道或文件在解码、编码时失败。

建议的排查顺序

以下为本站编排的操作建议，不表示已定位你的具体环境。

1. 保存第一段完整 traceback 或子进程错误。用启动 ComfyUI 的同一解释器记录 Python、PyAV、节点版本及安装来源：python -m pip show av。安装来源可信时，再用该解释器运行 python -c "import av; print(av.__version__); print(av.library_versions)"。

2. 若完全找不到模块，将节点声明的 PyAV 范围与解释器、发行版 wheel 要求比较，不能假定当前 18.1.0 支持旧 Python。若是原生导入或源码构建失败，保存第一条缺库、头文件或编译器错误，先核对具体 wheel/源码产物，再决定是否需要改系统 FFmpeg。

3. 只有报错确实来自外部进程时，才查节点实际选用的可执行文件路径，并测试同一个程序。FFmpeg 命令行版本与 av.library_versions 报出的库版本不是一回事。

4. 在可恢复副本中，用短且非私人的视频测试报错节点：打开文件、读取一帧，以及所需音轨或输出编解码器。保留原始输入，每次只改一个依赖。