1. Binary Wheels（推荐方式）
通过 PyPI 安装预编译的二进制包，已链接 FFmpeg，支持 Linux、macOS 和 Windows。
pip install av
内置 FFmpeg 版本与特性
FFmpeg 版本：6.1.1
全平台启用特性：
fontconfig, gmp, libaom, libass, libbluray, libdav1d, libfreetype, libmp3lame, libopencore-amrnb/amrwb, libopenjpeg, libopus, libspeex, libtwolame, libvorbis, libvpx, libx264, libx265, libxml2, libxvid, lzma, zlib仅 Linux 额外启用：
gnutls, libxcb
2. Conda 安装
通过 conda-forge 渠道安装：
conda install av -c conda-forge
💡 提示：新手可参考 Conda 官方快速安装文档配置 (mini)Conda 环境。
3. 使用自定义 FFmpeg 编译
PyAV 支持链接自行编译的 FFmpeg（要求版本 ≥ 6.0）。
强制从源码安装
pip install av --no-binary av
系统依赖
各平台快速配置
macOS
brew install ffmpeg pkg-config
Ubuntu (≥ 18.04 LTS)
# 通用依赖
sudo apt-get install -y python-dev pkg-config
# FFmpeg 库组件
sudo apt-get install -y \
libavformat-dev libavcodec-dev libavdevice-dev \
libavutil-dev libswscale-dev libswresample-dev libavfilter-dev
Windows
下载 FFmpeg shared 和 dev 包并解压（如
C:\ffmpeg）。编译时指定 FFmpeg 路径：
python setup.py build --ffmpeg-dir=C:\ffmpeg
4. 从最新源码构建
适用于需要最新开发版或参与贡献的场景。
# 1. 克隆仓库
git clone https://github.com/PyAV-Org/PyAV.git
cd PyAV
# 2. 准备虚拟环境
source scripts/activate.sh
# 3. 安装基础依赖
pip install -r tests/requirements.txt
# 4. （可选）构建 FFmpeg 依赖
./scripts/build-deps
# 5. 编译 PyAV
make
⚠️ 平台特殊注意事项
💡 安装排查备忘
优先使用 Binary Wheels：除非有特殊编解码器需求或平台不支持，否则直接用
pip install av最省事。版本兼容性：自定义 FFmpeg 编译时，务必确认版本 ≥ 6.0，低版本不被支持。
pkg-config 是关键：源码编译失败时，首先检查
pkg-config是否正确安装且能识别 FFmpeg 库。Windows 用户注意：无 Conda 环境下必须手动配置 FFmpeg 路径，这是最常见的 Windows 编译失败原因。
macOS 编译器问题：若遇到 clang/gcc 相关编译错误，记得设置
ARCHFLAGS环境变量。