安装系统级 FFmpeg 并配置环境变量是解决 ComfyUI 运行 AnimateDiff 工作流报错 FFMPEG 缺失的最推荐方案，适用于 Windows、macOS 和 Linux 系统。风险边界在于环境变量配置错误会导致 ComfyUI 控制台仍然无法调用 FFmpeg。
先说结论：FFmpeg 是 ComfyUI 的外部依赖组件，默认不随主程序安装，需手动配置系统路径。
- 先确认：在系统终端运行 ffmpeg -version 查看是否识别命令
- 先处理：通过包管理器或官网二进制包安装 FFmpeg 并写入 PATH
- 再验证：重启 ComfyUI 后观察控制台日志是否有 FFmpeg 加载提示
命令速用版
根据不同操作系统，使用以下命令可直接安装 FFmpeg 并自动配置环境变量。
# Windows (需先安装 Chocolatey 包管理器)
choco install ffmpeg -y
# macOS (需先安装 Homebrew)
brew install ffmpeg
# Ubuntu/Debian Linux
sudo apt update && sudo apt install ffmpeg -y
# CentOS/RHEL Linux
sudo yum install ffmpeg -y为什么会这样
ComfyUI 核心程序不包含 FFmpeg 二进制文件，因为 FFmpeg 是独立的开源多媒体框架，授权协议和体积不适合直接捆绑。
AnimateDiff 工作流中的视频合成节点（如 Video Combine 或 AnimateDiff Evolved 相关节点）需要调用系统路径下的 FFmpeg executable 进行编码。如果系统环境变量 PATH 中没有 FFmpeg 路径，节点调用失败就会报错缺失。
分步处理
按照以下步骤手动安装并配置，适用于无法使用包管理器的场景。
步骤 1：下载二进制包
访问 FFmpeg 官网下载对应系统的构建版本。Windows 用户建议下载 shared 或 static builds，解压后找到 bin 文件夹。
步骤 2：配置环境变量（Windows 重点）
在系统设置中找到“环境变量”，编辑“系统变量”中的 Path，新增 FFmpeg bin 文件夹的绝对路径。例如C:\ffmpeg\bin。修改后必须关闭并重新打开命令行工具才能生效。
步骤 3：重启 ComfyUI
完全关闭 ComfyUI 控制台窗口，重新启动启动脚本。ComfyUI 在启动时会扫描系统路径，只有重启后才能识别新配置的环境变量。
怎么验证是否生效
通过命令行和 ComfyUI 日志双重验证安装结果。
命令行验证：打开新的终端窗口，输入ffmpeg -version。如果输出版本信息而非“不是内部或外部命令”，说明系统级配置成功。
日志验证：观察 ComfyUI 启动日志。部分视频节点在加载时会打印 FFmpeg 路径检测信息。运行一次包含视频输出的工作流，确认不再报错 FFmpeg missing。
常见坑
列出容易出错的点，提醒哪些场景应该谨慎。
- 环境变量缓存：Windows 修改 Path 后，已打开的命令行窗口不会立即生效，必须新开窗口验证。
- 权限问题：Linux/macOS 安装时若遇到 Permission denied，需在命令前加 sudo 或使用用户级包管理器。
- 多版本冲突：如果系统中已存在旧版 FFmpeg（如通过 Anaconda 安装），可能导致版本不兼容，建议优先使用系统包管理器安装的版本。
常见问题
FFmpeg 应该放在 ComfyUI 文件夹内吗？
不建议直接放在 ComfyUI 文件夹内，除非手动指定节点配置路径。
放在系统环境变量 PATH 中是通用方案，能让所有依赖 FFmpeg 的节点都能调用，维护更方便。
安装后需要重启电脑吗？
不需要重启电脑，但必须重启 ComfyUI 程序和命令行终端。
环境变量加载发生在进程启动时，重启相关进程即可读取最新配置。
报错 ImageMagick 缺失也要这样处理吗？
是的，ImageMagick 也是外部依赖，处理逻辑与 FFmpeg 类似。
部分工作流同时依赖两者，建议一并安装，避免视频生成后处理环节报错。
参考来源
- ComfyUI 官方 GitHub 仓库：https://github.com/comfyanonymous/ComfyUI
- FFmpeg 官方下载页面：https://ffmpeg.org/download.html