FFmpeg 找不到：终端可用不代表节点进程也能找到

现象与适用范围

视频读取、转码、合成或预览节点提示找不到 FFmpeg 可执行程序。首先确认是可执行文件缺失，还是编码器、输入文件或节点内部路径错误，不要仅凭日志出现 ffmpeg 就重新安装全部视频依赖。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

ffmpeg not found
No such file or directory: 'ffmpeg'
ffmpeg

已核对的依据

VideoHelperSuite 的媒体处理和高级预览会用到 FFmpeg。当前解析代码先采用 VHS_FORCE_FFMPEG_PATH；否则会考虑 imageio_ffmpeg、进程 PATH 和工作目录里的候选文件，VHS_USE_IMAGEIO_FFMPEG 还能指定使用 imageio 候选。多个候选时节点会评分选择。因此在终端运行 ffmpeg -version 只能检查该终端 PATH 中的候选，不能确认 VHS 最终用了它；文件不存在错误还要核对实际失败路径。VHS 路径解析源码 R02 P07

需要区分的情况

1. VHS 找不到可用的 FFmpeg 候选，或显式设置的 VHS_FORCE_FFMPEG_PATH 指向缺失或不可用文件。

2. 终端、桌面应用、虚拟环境或容器的 PATH、工作目录及 VHS/imageio 覆盖设置不同；终端成功可能测的是另一份程序。

3. 可执行程序已经找到，但真正失败的是输入资源、编码器或参数，属于下一层错误。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 保存完整 traceback、stderr 与操作阶段，先核对报错中的路径，别预设缺的是 FFmpeg 而不是输入媒体。

第 2 步。 记录 ComfyUI 实际启动环境中的 VHS_FORCE_FFMPEG_PATH、VHS_USE_IMAGEIO_FFMPEG、PATH 和工作目录。按已安装 VHS 版本的解析逻辑找到实际选中的程序，再对该精确路径执行 -version；另一个终端的 ffmpeg -version 只测它自己的 PATH 候选。

第 3 步。 若没有选中可用程序，按官方说明使用可信 FFmpeg 分发包或 VHS 支持的路径覆盖设置，并在改变启动环境后重启 ComfyUI 进程。若程序可启动但编码器失败，应检查所选程序的编码支持。

第 4 步。 在相同节点及启动条件下，用短小正常视频测试读取和导出，核对实际调用的程序及生成文件；版本命令成功本身不证明编码或输入访问成功。

可复制的检查命令

确定 VHS 实际选中的可执行程序后再运行以下只读命令；若它不是 PATH 中的 ffmpeg，需替换为该程序的精确路径。本站未在你的机器上执行：

ffmpeg -version
ffmpeg -encoders

如何判断处理有效

节点调用到实际选中的程序，并完成小规模媒体读取和导出。版本号或编码器列表本身不证明完整工作流及所有格式都可用。

注意事项与尚未确认的部分

不要从不明站点下载所谓 codec 修复 exe。ffmpeg Python 封装包与 FFmpeg 程序不是同一个组件。

资料及中文语言审查日期：2026-09-26。本站未运行 VHS、导出媒体或进行 GPU 测试。

原始资料

• R02 · VideoHelperSuite README。核对：2026-09-26。
• P07 · Python errno。核对：2026-09-26。
• VHS · FFmpeg 路径解析源码。核对：2026-09-26。

相关排查与操作

• 视频导出失败、黑屏或时长不对：检查编码与帧率链路
• VideoHelperSuite 参考：读取帧、处理音频、合成视频与保存