Node.js新手使用node-ffmpeg生成MP4缩略图时遇ffmpeg命令未识别错误
解决Node.js生成MP4缩略图时'ffmpeg'未识别的问题
兄弟,这个错误其实很好排查——你用的node-ffmpeg只是个Node.js封装库,它本质上还是调用本地系统里的FFmpeg命令行工具,现在提示未识别,说明你的电脑里还没装FFmpeg本体,跟Node.js库没关系。
给你分系统说下安装步骤,按自己的系统来就行:
1. Windows系统
- 先下载FFmpeg的安装包(选「full build」版本就够用,不用纠结复杂选项)
- 把压缩包解压到一个固定路径,比如
C:\ffmpeg - 找到解压后的
bin文件夹(里面有ffmpeg.exe核心程序),把这个文件夹的完整路径(比如C:\ffmpeg\bin)添加到系统环境变量的PATH里 - 重启你的终端或者VS Code,再运行代码试试
2. macOS系统
直接用Homebrew安装就行,打开终端跑这条命令:
brew install ffmpeg
3. Linux系统(Ubuntu/Debian为例)
终端里依次运行这两条命令:
sudo apt update sudo apt install ffmpeg
验证安装是否成功
打开终端输入:
ffmpeg -version
如果能显示FFmpeg的版本信息,就说明安装到位了。
额外小技巧(不想改环境变量的话)
要是不想折腾系统环境变量,也可以在代码里直接指定FFmpeg的绝对路径,比如Windows下:
const ffmpeg = require('node-ffmpeg'); const videoProcess = new ffmpeg('./your-video.mp4', { ffmpegPath: 'C:\\ffmpeg\\bin\\ffmpeg.exe' // 换成你自己的ffmpeg.exe路径 });
macOS或Linux的话,直接写FFmpeg的安装路径就行,比如/usr/local/bin/ffmpeg。
内容的提问来源于stack exchange,提问作者Wai Yan Hein




