VSCode需三步配置Node+FFmpeg音视频环境：确保Node可执行、使ffmpeg命令在VSCode内可调用、用child_process或fluent-ffmpeg安全触发；关键在理清执行上下文与路径权限，而非依赖插件。
VSCode 本身不提供 Node + FFmpeg 的“开箱即用”音视频处理环境，但你可以通过三步明确控制：确保 Node 可执行、让 ffmpeg 命令在 VSCode 内可调用、再用 child_process 或 fluent-ffmpeg 在代码里安全触发。关键不是装一堆插件，而是理清执行上下文和路径权限。
为什么 node 能跑但 ffmpeg 报 command not found
VSCode 启动时继承的是登录 Shell 的 PATH（比如 macOS 的 zsh、Windows 的 PowerShell），但 tasks.json 或 JS 中的 execSync 默认走 /bin/sh（macOS/Linux）或 cmd.exe（Windows）——这两者未必加载你配置的 PATH。
- 在终端里运行
which ffmpeg（macOS/Linux）或where ffmpeg（Windows CMD），确认路径真实存在 - 别只信 Git Bash 或 PowerShell 里能跑，得验证
cmd.exe或/bin/sh下是否同样可执行 - 如果不行，要么把 FFmpeg 路径硬编码进 Node 脚本（见下节），要么在 VSCode 设置里改
terminal.integrated.defaultProfile指向你信任的 Shell
Node.js 脚本中调用 ffmpeg 的两种可靠写法
直接用 child_process.execSync 最轻量，但容错差；用 fluent-ffmpeg 更健壮，适合生产逻辑。两者都绕不开路径问题。
- 硬编码路径（适合开发机固定安装）：
const { execSync } = require('child_process');<br>execSync('C:/ffmpeg/bin/ffmpeg.exe -i input.mp4 -c:v libx264 output.mp4', { stdio: 'inherit' }); - 用
fluent-ffmpeg自动探测 + 手动指定（推荐）：const ffmpeg = require('fluent-ffmpeg');<br>ffmpeg.setFfmpegPath('C:/ffmpeg/bin/ffmpeg.exe'); // Windows 示例<br>ffmpeg.setFfprobePath('C:/ffmpeg/bin/ffprobe.exe');<br>ffmpeg('input.mp4').output('output.mp4').withVideoCodec('libx264').run(); - 注意：Windows 路径中的反斜杠
在 JS 字符串里要写成\或用正斜杠/，否则解析失败
VSCode tasks.json 中运行 FFmpeg 的避坑要点
想点一下就转码？tasks.json 是最干净的方式，但参数写错会静默失败或卡住。
- 必须设
"isBackground": false，否则 VSCode 认为任务无输出而提前终止 - 加
-y参数，否则遇到同名文件会卡在交互等待 - 路径变量用
${file}（当前文件）、${fileDirname}（目录），避免空格和中文路径出错
例如："args": ["-i", "${file}", "-c:v", "libx264", "${fileDirname}/${fileBasenameNoExtension}_h264.mp4", "-y"] - Windows 用户注意：
cmd.exe不认单引号，所有路径必须用双引号包裹，且反斜杠要转义或统一换为/
最易被忽略的是执行环境隔离：VSCode 内置终端、task、debugger、JS 运行时，四者 PATH 和 Shell 可能各不相同。不要假设“终端里能跑，代码里就一定行”。每次出错，先用 console.log(process.env.PATH) 和 process.platform 打印上下文，再比对 ffmpeg 实际位置。路径对了，90% 的问题就消失了。
