mpv：自由的命令行媒体播放器编译与使用指南

官方信息表

配图

项目背景

mpv 是一个“自由（as in freedom）的命令行媒体播放器”，README 在 Overview 一节开门见山：它支持种类繁多的媒体文件格式、音频与视频编解码器，以及字幕类型。和那些带华丽界面的桌面播放器不同，mpv 的核心是一个命令行程序——你在终端里给它一个文件路径或 URL，它就能把画面播出来，同时背后还藏着一整套可脚本化、可远程控制、可被其他程序嵌入的播放能力。

它之所以被很多高级用户奉为“播放天花板”，在于它把播放这件事拆成了无数可调的选项：你可以用硬件解码、自定义音视频同步、逐帧控制、字幕样式、画面着色器（shader）、任意缩放算法。README 专门提醒，mpv 是高度可配置的，manual 里有完整的选项列表；它还支持 Lua 脚本和 JSON IPC，意味着你可以写一个小程序远程控制 mpv 的播放进度、速度、音轨，甚至把它嵌进自己的应用里当播放器内核用。

最常见的用法就是在终端里 mpv 文件名 或 mpv 视频地址，它会弹出一个窗口开始播放；播放中按空格暂停、按 ←/→ 快退快进、按 9/0 调音量、按 f 全屏、按 q 退出。它也能直接播网络地址，把 mpv 放在脚本里用来自动播放或录屏都很常见。对追求画质的用户，它支持 VapourSynth 滤镜、自定义着色器、多音轨字幕切换，几乎是“能想到的播放调节都有”。

它还支持从命令行一次性指定很多行为，比如 mpv --hwdec=auto 视频 开硬件解码、mpv --volume=50 视频 固定音量、mpv --loop-file=inf 视频 循环播放、mpv --speed=1.5 视频 1.5 倍速。这些参数也可以写进 ~/.config/mpv/mpv.conf 里做成默认配置，省去每次敲命令。

总的来说，mpv 是一个把“播放”做成高度可配置、可脚本化、可嵌入内核的自由播放器：你可以用它当日常播放器，也可以把它的内核嵌进自己的应用里，还能写脚本远程控制。它不追求华丽界面，而追求“能想到的调节都能调”，是高级用户和开发者眼里的播放利器。

它在自由软件社区维护多年，支持从命令行到图形前端、从本地文件到网络流的各种播放场景，是视频播放领域里非常有代表性的 C 项目。

README 在 History 一节说明了它的来历：mpv 基于 MPlayer 项目，在 mpv 正式成为一个独立项目之前，这套代码曾短暂地在 mplayer2 项目下开发过。这意味着 mpv 继承了 MPlayer 时代积累下来的、对各种冷门格式和编解码器的强大兼容性，但又在现代化的代码结构、渲染管线和用户体验上做了大量改进。

mpv 最被人称道的一点，是它对视频渲染质量的追求。README 在 System requirements 一节特意提到：mpv 的主视频输出是用 shader 做渲染和缩放，而不是依赖 GPU 的固定功能硬件；正因为如此，它对 GPU 有一定要求，太弱的集成显卡可能出现撕裂、卡顿等问题。这种把“画质”放在“省电”之前的取向，让 mpv 在发烧友和追求画面质量的用户中口碑极高，也让它被许多其他播放器当作播放内核来内嵌。

核心特性逐条翻译

README 没有用传统的“Features 列表”，而是通过 Overview、System requirements、Compilation 等章节把能力讲清楚，下面逐条翻译并展开。

广泛的格式与编解码器支持。 README 开篇就强调支持“a wide variety of media file formats, audio and video codecs, and subtitle types”。它能读的不仅是本地文件，也包括网络流；配合可选的 Lua 支持和 youtube-dl 集成，很多在线视频地址也能直接拖进 mpv 播放。

现代化的 shader 渲染管线。 README 说明主视频输出用 shader 进行视频渲染和缩放，而不是走 GPU 固定功能。这是 mpv 画质出色的根本原因，也意味着它对 GPU 有一定要求——低功耗显卡上可能出现撕裂、卡顿，官方建议在这种环境下用 --profile=fast 获得流畅播放。

可选的硬件解码。 README 指出硬件解码可能在 CPU 太弱、没法实时解码视频时帮上忙，但必须用 --hwdec 选项显式开启，默认并不启用。在 Linux 上，要使用 nvdec 和 vaapi 做硬件解码，还需要对应的库。

这种“默认不自动开硬件解码”的取舍，和 mpv 的画质取向是一致的：它优先用 shader 做高质量软件渲染，而不是为了省电把画面交给 GPU 固定功能单元。只有当你的 CPU 实在跟不上实时解码时，才建议手动加 --hwdec，让显卡分担解码工作。

基于 meson 的现代化构建。 README 明确 mpv 要求用 meson 来构建，而不是老牌的 autotools。构建选项可以通过 meson configure build 查看，日志放在构建目录的 meson-logs 里。

可脚本化与可扩展。 README 的 External links 一节列出了 Wiki、User Scripts、FAQ 和完整手册。Lua 是可选依赖，但它是 OSC 伪 GUI 和 youtube-dl 集成所必需的。

环境要求与部署

README 把运行环境要求写得很实在，部署分“直接用现成构建”和“自己编译”两条路线。

运行环境

README 要求：一个不太古老的 Linux（通常只积极支持各发行版的最新版本）、Windows 10 1607 或更新版本、macOS 10.15 或更新版本；CPU 要“还算能打”，硬件解码要显式开启；GPU 不要太差，mpv 并不追求在嵌入式或集成显卡上省电播放，老 GPU 上甚至建议用 --vo=xv 之类的旧式回退输出，但官方并不推荐也不支持这种做法。

方式一：下载现成构建（推荐）

对于普通用户，README 直接指向 mpv.io/installation，那里提供半官方构建和第三方打包。你不需要自己装一堆依赖，下载对应平台的包即可使用。

方式二：从源码用 meson 编译

README 给出的标准编译三步是：

meson setup build
meson compile -C build
meson install -C build

如果构建环境里没有足够新的 libplacebo，README 说明可以把它作为 git subproject 克隆进来，meson 会静态链接它：

mkdir -p subprojects
git clone https://code.videolan.org/videolan/libplacebo.git --depth=1 --recursive subprojects/libplacebo

README 列出的核心依赖包括：gcc 或 clang；X 开发头文件（xlib、xrandr、xext、xscrnsaver、xpresent、libvdpau、libGL、GLX、EGL、xv 等）；音频输出开发头文件（libasound/ALSA、pulseaudio）；FFmpeg 系列库（libavutil、libavcodec、libavformat、libswscale、libavfilter，以及 libswresample 或 libavresample）；libplacebo；zlib；iconv；用于 OSC、OSC 和文字字幕的 libass；以及一堆可选依赖——Lua（OSC 伪 GUI 和 youtube-dl 集成）、libjpeg（仅截图用）、uchardet（字幕字符集检测）、nvdec/vaapi（Linux 硬件解码）。

如果你想图省事，README 推荐使用单独维护的构建封装 mpv-build，它会先编译 FFmpeg 库和 libass，再静态链接编译 mpv。要在 Windows 上编译，参考 Windows 编译文档。

使用方法

装好之后，最直接的用法是在终端里把文件或 URL 交给 mpv：

mpv 电影.mkv
mpv --hwdec https://example.com/stream.m3u8

播放过程中，mpv 提供了一套键盘快捷键控制播放、暂停、seek、音量、字幕切换；完整的按键和选项都在官方手册里。README 特别提到，默认按键绑定的变化会记录在 restore-old-bindings.conf 中，如果你习惯了旧版按键，可以用它恢复。

和图形化播放器相比，mpv 的交互哲学是“键盘优先、极简界面”。你不需要用鼠标在界面上找按钮，几乎所有操作都对应一个按键：空格暂停、方向键快进快退、9/0 调音量、# 切换字幕。这种操作方式在看视频、监控流、远程无头播放时特别高效——你甚至可以在一个没有图形界面的服务器上，用 mpv 配合音频输出做纯音频播放或转码。

mpv 的一大优势是高度可配置：你可以通过命令行选项、配置文件、以及 Lua 脚本去改变它的行为，甚至把它当作播放内核嵌进自己的程序里（它有一套 C API，相关变化记录在 client API changelog 中）。社区维护的 User Scripts 里有大量现成脚本，实现了字幕下载、画质调节、缩略图预览等扩展功能。

从用户体验上说，mpv 刻意保持了“键盘优先、无冗余界面”的风格：默认界面非常干净，没有一堆按钮和侧边栏，所有操作都通过快捷键和命令完成。这种风格一方面让习惯键盘操作的用户觉得高效、专注，另一方面也让 mpv 可以被嵌入到各种场景里——比如作为其他应用的播放内核、作为大屏设备的播放程序，或者作为服务器上无界面播放转码的工具。README 提到的 OSC（屏幕上显示的伪 GUI）是可选的，需要 Lua 支持才会出现。

发布与维护节奏

README 在 Release cycle 一节说明：mpv 大约一年发布一到两次，从当前开发状态切出一个 0.X.0 版本号，除安全问题外不再做额外维护。发布版本的目标是“让 Linux 发行版满意”，也就是说发行版会自己再打补丁修复 bug；除最新版之外的旧版本都不受支持、不再维护。如果你想跟踪 bleeding edge，可以直接编译 git master；如果想要稳定省心，就跟着发行版打包的版本走。

常见问题（FAQ）

问：mpv 和 MPlayer 是什么关系？ README 在 History 一节说明：mpv 基于 MPlayer 项目，在成为独立项目前，代码曾短暂在 mplayer2 项目下开发。它继承了 MPlayer 强大的格式兼容性，但做了现代化改造。

问：mpv 默认开硬件解码吗？怎么开？ README 说明硬件解码不会默认开启，必须显式用 --hwdec 选项打开；在 CPU 太弱、没法实时解码时再开，而且在 Linux 上还需要 nvdec/vaapi 对应的库。

问：我的电脑是集成显卡，播放卡顿怎么办？ README 建议在这种低功耗 GPU 上使用 --profile=fast 来获得更平滑的播放；并提醒 Windows 上要确保显卡驱动是最新的。

问：从源码编译需要哪些主要依赖？ README 列出：gcc/clang、X 开发头文件、ALSA/pulseaudio 音频库、FFmpeg 全套库、libplacebo、zlib、iconv、libass，以及可选的 Lua、libjpeg、uchardet、硬件解码库。嫌麻烦可以用 mpv-build 一键构建。

问：mpv 是什么许可证？可以改 LGPL 吗？ README 说明默认是 GPLv2 “or later”；如果在编译时加 -Dgpl=false，就可以以 LGPLv2.1 “or later” 分发，具体见 Copyright 文件。

问：遇到问题去哪里问？ README 给出：bug 报告和功能请求走 GitHub issue tracker，使用问题可以在 Discussions 或 IRC 频道 #mpv（irc.libera.chat）讨论；常见问题先看 FAQ。README 特别提醒，提 bug 时要按 issue 模板的说明填写，否则很可能被直接忽略或关闭为无效。

问：mpv 为什么不用传统的 autotools 构建？ README 明确要求用 meson，这是 mpv 现代化构建体系的一部分。meson 把构建配置、依赖检测、编译、安装串起来，你可以用 meson configure build 查看所有构建选项，日志放在构建目录的 meson-logs 里，比 autotools 时代更清晰可控。

问：mpv 能播在线视频和网络流吗？ 可以。README 把 Lua 列为可选依赖，并说明它是 OSC 伪 GUI 和 youtube-dl 集成所必需的；只要装了 Lua 并配好 youtube-dl，你就可以把很多在线视频地址直接交给 mpv 播放，而不必打开浏览器。

问：mpv 适合被嵌进我自己的程序里吗？ 适合。README 提到 mpv 有一套 C API，并且专门维护了一份 client API changelog 记录接口变化。很多第三方播放器正是把 mpv 当作播放内核嵌进自己的界面里，利用它成熟的解码、渲染和字幕能力，而自己只做外壳。如果你想在自己的应用里加一个高质量的视频播放组件，这是一条经过大量实践验证的路线。

跳转链接

• 官方代码仓库：mpv-player/mpv
• 官方网站：mpv.io
• 完整手册：mpv.io/manual/master
• 安装下载：mpv.io/installation
• 官方 Wiki：github.com/mpv-player/mpv/wiki
• 用户脚本：User Scripts
• 常见问题：FAQ
• 一键构建封装：mpv-build
• Windows 编译指南：compile-windows.md