VideoHelperSuite：ffmpeg is required for video outputs and could not be found

ffmpeg is required for video outputs and could not be found
（注：以上为转述文本，非逐字原文。）

现象与触发场景

常见触发场景：

• ComfyUI Desktop / 手动源码安装，PATH 里没有 ffmpeg
• 系统里装了一个很老的 ffmpeg，VideoHelperSuite 优先调用系统版而失败
• Python 环境里没有 imageio-ffmpeg（便携版通常自带，Desktop 或自定义环境可能没有）

根因

• VideoHelperSuite 合成视频时要用 ffmpeg 可执行文件：它优先找系统 PATH 里的 ffmpeg，找不到时回退到 Python 包 imageio-ffmpeg 自带的二进制；两者都没有就报找不到 ffmpeg
• 系统 ffmpeg 版本过旧时，某些编码器/参数不被支持，表现同样是合成失败（维护者在 issue 中明确说明代码会优先使用系统版本，所以旧系统 ffmpeg 会拖累）
• 输出无声/格式选项中缺 h264，往往不是 ffmpeg 缺失而是未选对视频格式/编码器，或系统 ffmpeg 未带对应编码支持

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

1. 先用 Python 层面的 imageio-ffmpeg 兜底，不改系统 PATH
   VideoHelperSuite 在没有系统 ffmpeg 时会使用 imageio-ffmpeg 自带的二进制。用便携版解释器安装它，是最干净的办法——不污染系统环境、也不需要管理员权限。装完完全重启 ComfyUI。
   cd ComfyUI\custom_nodes\comfyui-videohelpersuite
   ..\..\python_embeded\python.exe -m pip install imageio-ffmpeg
2. 或者安装系统 ffmpeg 并加入 PATH（Windows 推荐用 winget 或解压后手工加 PATH）
   到 ffmpeg 官网/gyan.dev 下载 Windows 构建，解压后把 bin 目录加入系统 PATH；或使用 winget 安装。加完 PATH 必须重开命令行窗口与 ComfyUI 进程才生效。注意不要装过旧版本，旧版会因缺少编码器导致合成失败。
   winget install Gyan.FFmpeg
3. 核对 Video Combine 的输出格式与是否合成了音频
   Video Combine 节点上有格式/编码器（如 h264）与是否合并音频的开关。若节点列表里没有 h264 选项，通常是该环境的 ffmpeg 不带对应编码支持；先修好 ffmpeg 再回来看选项。要带音频时，音频必须真的连到节点的 audio 输入上，不能只连图像。
4. 确认二进制真的能被找到
   在同一个命令行窗口里执行 ffmpeg -version，确认系统 ffmpeg 可见；再用便携版解释器验证 imageio-ffmpeg 能否给出二进制路径。两者至少有一个可用，节点才不会再报找不到 ffmpeg。
   ffmpeg -version
   ..\..\python_embeded\python.exe -c "import imageio_ffmpeg; print(imageio_ffmpeg.get_ffmpeg_exe())"

验证是否修好

补充说明

error_text 未能从搜索结果中拿到 issue 正文的逐字原文，故按节点仓库 issue 标题与社区文章中反复出现的提示语整理，error_text_verbatim 标为 false。ffmpeg 优先使用系统版本的机制来自维护者在 issue #149 的说明。

来源

1. [236] （节点仓库 issue）　FFMPEG not found - ComfyUI Desktop　https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite/issues/349
2. [237] （节点仓库 issue）　The only thing that comes to mind is that the system version of ffmpeg　https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite/issues/149
3. [238] （节点仓库 issue）　h264 is not displayed in the format options of Video Combine.　https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite/issues/188
4. [239] （中文社区）　ComfyUI-VideoHelperSuite拓展报错ffmpeg is required for video outputs and c　https://www.cnblogs.com/Coil1773647/p/18794634

本条报错提到的节点仓库

下面这些节点仓库的名字出现在本条报错的正文里。这里只说「名字出现过」，没有断定问题就是它引起的； 点进去可以看这个包的用途、适配模型与下载量。

这条报错要用到的东西

按本条报错所属的类别（热门自定义节点/工作流专有报错）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库