您的位置首页 >人工智能 >

保姆级教程Windows 从零编译 FFmpeg 全流程,绕开 MSYS2,附 5 个真实踩坑与 20MB 产物实测

Windows 下不用 MSYS2 也可以独立编译 FFmpeg,这套方案使用 w64devkit 工具链,全程不需要安装 MSYS2 环境,最终可以编译出体积约 20MB、独立可用的 ffmpeg.exe,适合不想装 MSYS2、嫌 MSYS2 包管理麻烦、想要便携编译环境的用户。大部分网上教程默认走 MSYS2,是因为 FFmpeg 的 configure 脚本依赖 POSIX shell,而 MSYS2 自带整套环境,但是 w64devkit 内置了 busybox、gcc、make、tar、xz 等全套组件,是可以替代 MSYS2 的轻量化方案,同时这套流程里面整理了 5 个高频报错踩坑点,都是实测过程里真实遇到的,跟着步骤操作可以避开大部分编译卡壳问题。

一、准备编译环境和源码

  1. 下载 w64devkit,选择稳定版本,解压到无中文、无空格的路径,例如 D:\w64devkit,不要放在桌面、中文文件夹里;
  2. 下载 FFmpeg 官方 release 源码包,本次实测使用 ffmpeg 7.1 版本,同样解压到纯英文路径,D:\ffmpeg-src;
  3. 准备 nasm 汇编工具,把 nasm.exe 放到 w64devkit 的 bin 目录,否则汇编优化代码编译失败;
  4. 可选依赖:zlib,如果需要 GIF、部分压缩功能,提前编译好 zlib,头文件和库文件路径后面配置传入。

环境核对清单

| 项目 | 要求 |

| 工具链 | w64devkit,内置 gcc、make、busybox sh |

| 源码 | FFmpeg 官方稳定 release 包,不建议直接拉 master 开发分支 |

| 必备组件 | nasm.exe,加入 PATH |

| 路径规范 | 全部目录不能有中文、空格、特殊符号 |

二、启动环境并执行 configure 配置

打开 w64devkit 的启动 bat 脚本,进入内置的 shell,cd 切换到 ffmpeg 源码目录,这一步是最容易报错的环节。

核心配置命令示例:

./configure --arch=x86_64 --target-os=mingw32 --prefix=./build-out --enable-gpl --disable-doc

重点参数说明:

  • --target-os=mingw32:这是绕开 Unknown OS 'windows_nt' 报错的关键,手动指定目标系统,不让脚本自动识别 Windows_NT;
  • --prefix:指定编译产物输出目录;
  • --disable-doc:关闭文档编译,节约编译时间;
  • 需要 zlib 就追加 --enable-zlib 并补充 extra-cflags、extra-ldflags 指向 zlib 目录。

配置成功之后,目录下会生成 ffbuild 文件夹和 Makefile 文件,如果配置失败优先看 ffbuild/config.log 排查原因。

三、编译和安装输出产物

配置通过后执行编译命令,根据 CPU 核心数加 - j 参数加速:

make -j8

make install

编译完成后,到 --prefix 指定的 build-out 目录,bin 文件夹里面就能拿到 ffmpeg.exe、ffprobe.exe,本次实测静态编译后的 ffmpeg.exe 大小约 20.3MB,不依赖额外 dll,直接在 Windows 双击或者 cmd 调用都能运行,测试转码、生成 GIF、视频信息探测功能正常。

四、5 个真实踩坑问题和解决办法

坑 1:报错 Unknown OS 'windows_nt'

原因:shell 自动 uname 识别系统为 Windows_NT,configure 脚本不识别这个标识。

解决:配置命令强制加上 --target-os=mingw32,不要让脚本自动判断系统。

坑 2:找不到 nasm,asm 相关模块编译失败

原因:PATH 里面没有 nasm,FFmpeg 汇编优化代码依赖 nasm。

解决:下载 nasm,把 nasm.exe 放到 w64devkit/bin,重启 shell 再重新 configure。

坑 3:误删除 ffbuild 目录导致编译中断

原因:很多人清理缓存的时候直接删掉 ffbuild,里面存放配置缓存、日志、生成的配置文件。

解决:不要手动删除 ffbuild,重新配置只需要执行 make clean,需要彻底重建再删这个目录。

坑 4:zlib 缺失,GIF 转码功能异常

原因:没开启 zlib 的情况下,GIF 编码相关逻辑会报错,转 GIF 失败。

解决:先使用同工具链编译 zlib,配置 ffmpeg 的时候传入 zlib 头文件和库路径,加上 --enable-zlib。

坑 5:路径带中文 / 空格,configure 直接异常退出

原因:busybox、gcc 对 Windows 中文路径支持很差,路径识别截断。

解决:全部源码、工具链、输出目录统一放到纯英文短路径。

五、验证编译产物

打开 Windows 原生 cmd,进入 ffmpeg.exe 所在文件夹,执行

ffmpeg -version

能正常输出版本信息,再简单测试转码,确认音视频编码、滤镜功能正常,就代表编译成功。这套绕开 MSYS2 的方案,适合需要定制编译参数、精简 ffmpeg 体积、不想维护 MSYS2 包列表的用户,缺点是外部依赖(x264、zlib 等)都需要自己用同一个 w64devkit 工具链提前编译,不能像 MSYS2 一样 pacman 一键装依赖。

【相关 FAQ】

问题 1:Windows 绕开 MSYS2 编译 FFmpeg,w64devkit 和 MinGW 有什么区别?

回答 1:w64devkit 是打包好的便携 MinGW-w64 套装,自带 sh、make 等 POSIX 工具,不需要额外安装配置,刚好满足绕开 MSYS2 编译 FFmpeg 的需求;传统 MinGW 很多版本缺少配套 shell 工具,单独搭配起来更麻烦。

问题 2:绕开 MSYS2 编译出来的 FFmpeg,和 MSYS2 编译的 FFmpeg 有功能差别吗?

回答 2:核心编码解码能力没有区别,区别只在于依赖管理,绕开 MSYS2 方案下 x264、zlib 这类第三方库要手动编译接入,MSYS2 可以直接包管理器安装依赖,两者产出的 ffmpeg.exe 都可以在 Windows 独立运行。

问题 3:Windows 不用 MSYS2 编译 FFmpeg,能不能开启硬件加速 NVENC?

回答 3:可以,前提是提前下载 nv-codec-headers,使用同一个 w64devkit 工具链编译,在 configure 参数中追加 nv 相关开启参数,同时保证显卡驱动支持 NVENC。

问题 4:Windows 绕开 MSYS2 编译 FFmpeg 时,make 编译速度很慢怎么优化?

回答 4:使用 - j 加上 CPU 线程数,比如 8 核 CPU 写 make -j8;同时加上 --disable-doc、--disable-programs 等关闭不需要组件,减少编译文件数量。

问题 5:绕开 MSYS2 编译 FFmpeg 报错 make 命令不存在是什么原因?

回答 5:大概率是没有在 w64devkit 自带的 shell 里面执行命令,Windows 原生 cmd 没有 make,必须启动 w64devkit 的内置 shell 环境再跑 configure 和 make。

【参考资料】

[2026-11-21](保姆级教程:Windows 从零编译 FFmpeg 全流程,绕开 MSYS2,附 5 个真实踩坑与 20MB 产物实测)阿里云开发者社区

[2026-10-27](MSVC 19.52 miscompiles ffmpeg for arm64)Visual Studio Developer Community

[2026-08-08](Platform Specific Information)FFmpeg 官方文档

[2022-03-24](CompilationGuide/MinGW)FFmpeg Trac

【免责声明】

本文仅为技术学习分享,Windows 绕开 MSYS2 编译 FFmpeg 的操作存在环境适配风险,不同 Windows 版本、工具链版本可能出现新的编译报错;编译生成的 FFmpeg 二进制仅可用于符合 FFmpeg 开源协议的场景,请严格遵守 GPL 协议相关要求,作者不承担因编译、使用该程序带来的任何直接或间接责任。

今日大家都在搜的词: