← 返回命令生成器

📖 FFmpeg 安装指南

详细的FFmpeg安装和配置教程，支持Windows、macOS、Linux等多个平台

Windows 安装指南

方法1：使用 Chocolatey (推荐)

这是最简单快捷的安装方法。

  1. 1. 安装 Chocolatey (如果未安装)

    以管理员身份打开 PowerShell，运行：

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://community.chocolatey.org/install.ps1 | iex
  2. 2. 安装 FFmpeg

    在 PowerShell 中运行：

    choco install ffmpeg -y
  3. 3. 验证安装 
    ffmpeg -version

方法2：手动下载

  1. 1. 下载 FFmpeg

    访问 https://ffmpeg.org/download.html

    选择 Windows 版本，或从 Gyan.dev 下载最新编译版本

  2. 2. 解压文件

    解压下载的 zip 文件到某个位置，例如 C:\ffmpeg

  3. 3. 添加到 PATH

    右键点击"此电脑" → 属性 → 高级系统设置 → 环境变量

    在系统变量中添加 FFmpeg 的 bin 文件夹路径（例如 C:\ffmpeg\bin）

  4. 4. 验证安装

    打开新的命令提示符，运行：

    ffmpeg -version

方法3：使用 Windows Package Manager

需要 Windows 10/11 且已安装 Winget

winget install FFmpeg

验证安装：

ffmpeg -version

⚠️ 故障排除

问题：显示 "ffmpeg 不是内部或外部命令"

解决方案：

  • 确认 FFmpeg 已正确安装
  • 检查 PATH 环境变量是否包含 FFmpeg bin 文件夹路径
  • 重启命令提示符或 PowerShell
  • 可能需要重启计算机

问题：权限不足错误

解决方案：以管理员身份运行命令提示符或 PowerShell

macOS 安装指南

方法1：使用 Homebrew (推荐)

Homebrew 是 macOS 最流行的包管理工具

  1. 1. 安装 Homebrew (如果未安装) 
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  2. 2. 安装 FFmpeg 
    brew install ffmpeg
  3. 3. 验证安装 
    ffmpeg -version

方法2：使用 MacPorts

  1. 1. 安装 MacPorts

    访问 MacPorts 并按照说明安装

  2. 2. 安装 FFmpeg 
    sudo port install ffmpeg
  3. 3. 验证安装 
    ffmpeg -version

方法3：手动下载预编译版本

  1. 1. 下载

    从 FFmpeg 官网 下载 macOS 版本

  2. 2. 解压并移动 
    tar xjf ffmpeg-*.tbz2
sudo mv ffmpeg /usr/local/bin/
  3. 3. 设置权限 
    sudo chmod +x /usr/local/bin/ffmpeg
  4. 4. 验证安装 
    ffmpeg -version

⚠️ 故障排除

问题：M1/M2 Mac 兼容性

如果使用 Homebrew 安装，它会自动选择合适的版本

验证是否支持原生 ARM64：

file $(which ffmpeg)

问题："无法打开文件"或权限错误

尝试在命令前添加 sudo，或检查文件权限

Linux 安装指南

Ubuntu / Debian

sudo apt update
sudo apt install ffmpeg

验证安装：

ffmpeg -version

Fedora / RHEL / CentOS

对于 RHEL/CentOS，需要先启用 EPEL 仓库：

sudo dnf install epel-release
sudo dnf install ffmpeg

验证安装：

ffmpeg -version

Arch Linux

sudo pacman -S ffmpeg

验证安装：

ffmpeg -version

openSUSE

sudo zypper install ffmpeg

验证安装：

ffmpeg -version

⚠️ 故障排除

问题：软件包未找到

确保已更新包管理器：

sudo apt update  # Ubuntu/Debian
sudo dnf check-update  # Fedora

问题：某些编码器不可用

可能需要安装额外的库或从源码编译。参考"从源码编译"部分

从源码编译 FFmpeg

💡 何时需要从源码编译？
当预编译版本缺少某些编码器、滤镜或库支持时，或需要最新功能时。

系统要求

  • • GCC 或 Clang 编译器
  • • 必要的开发库（yasm、nasm 等）
  • • Git（获取最新源码）
  • • Make 工具

编译步骤（Linux/macOS）

  1. 1. 安装依赖

    Ubuntu/Debian：

    sudo apt install build-essential yasm pkg-config libx264-dev libx265-dev libopus-dev libvpx-dev
  2. 2. 克隆仓库 
    git clone https://git.ffmpeg.org/ffmpeg.git ffmpeg
cd ffmpeg
  3. 3. 配置编译选项 
    ./configure --enable-gpl --enable-libx264 --enable-libx265 --enable-libopus --enable-libvpx

    常用选项：

    • --enable-gpl - 启用 GPL 库（必须）
    • --enable-libx264 - H.264 支持
    • --enable-libx265 - H.265 支持
    • --enable-libopus - Opus 音频
    • --enable-libvpx - VP8/VP9 支持
    • --prefix=/usr/local - 安装位置
  4. 4. 编译和安装 
    make -j$(nproc)
sudo make install
  5. 5. 验证安装 
    ffmpeg -version
ffmpeg -encoders | grep -i x264

Windows 上编译

Windows 上编译较为复杂，建议使用预编译版本或在 WSL 中编译

使用 WSL 编译：

  1. 安装 Windows Subsystem for Linux (WSL)
  2. 在 WSL 中按照 Linux 步骤编译
  3. 编译完成后的 ffmpeg 可在 Windows 中使用

⚙️ 高级配置

启用硬件加速

NVIDIA GPU：

./configure --enable-cuda-nvcc --enable-cuvid --enable-nvenc

Intel Quick Sync：

./configure --enable-libmfx

AMD VCE：

./configure --enable-amf

启用所有编码器

./configure --enable-gpl --enable-nonfree --enable-libx264 --enable-libx265 --enable-libopus --enable-libvpx --enable-libmp3lame --enable-libfdk-aac

查看所有可用选项

./configure --help | grep enable

❓ 常见问题 (FAQ)

Q: 如何检查已安装的编码器和滤镜？

ffmpeg -encoders        # 查看所有编码器
ffmpeg -decoders        # 查看所有解码器
ffmpeg -filters         # 查看所有滤镜
ffmpeg -protocols       # 查看所有协议

Q: 如何获取媒体文件信息？

ffprobe -show_format -show_streams input.mp4

Q: FFmpeg 版本过旧，如何升级？

使用包管理器卸载并重新安装：

sudo apt remove ffmpeg  # Debian/Ubuntu
sudo apt install ffmpeg

# 或从源码编译获取最新版本

Q: 某些编码器显示 "Unknown encoder"

这意味着 FFmpeg 编译时未启用该编码器。需要从源码重新编译，启用相应的库。

Q: 如何卸载 FFmpeg？

使用包管理器卸载：

sudo apt remove ffmpeg      # Debian/Ubuntu
brew uninstall ffmpeg       # macOS
choco uninstall ffmpeg -y   # Windows (Chocolatey)

如果是手动安装，删除相应文件和 PATH 配置即可。

📚 官方资源

🌐 FFmpeg 官网

获取最新版本和官方文档

📖 完整文档

FFmpeg 命令和 API 文档

🎬 编码指南

详细的编码器配置和优化

📐 视频缩放

缩放和分辨率处理指南

✅ 最佳实践

1

定期更新

定期更新 FFmpeg 以获得最新特性和安全补丁

2

验证功能

安装后运行 ffmpeg -version 确认安装成功

3

支持多个编码器

确保 FFmpeg 支持你需要的编码器（H.264、H.265、VP9 等）

4

测试编码

在批量处理前用单个文件测试你的命令

5

查看文档

参考官方文档了解各种选项和最佳实践