配置文件

本节介绍 mpv 的配置文件系统，帮助您自定义 mpv 的行为。

配置文件位置

mpv 使用两个主要配置文件：

主配置文件 (mpv.conf)

用于设置播放器选项：

• Windows: %APPDATA%/mpv/mpv.conf
• macOS: ~/.config/mpv/mpv.conf
• Linux: ~/.config/mpv/mpv.conf

输入配置文件 (input.conf)

用于自定义快捷键：

• Windows: %APPDATA%/mpv/input.conf
• macOS: ~/.config/mpv/input.conf
• Linux: ~/.config/mpv/input.conf

配置文件格式

mpv.conf 格式

每行一个选项，格式为：

选项=值
选项

示例：

# 视频输出
vo=gpu

# 音频输出
ao=wasapi

# 默认音量
volume=80

# 全屏启动
fs=yes

# 窗口大小
geometry=1280x720

input.conf 格式

每行一个快捷键绑定，格式为：

快捷键 命令 参数

示例：

# 自定义快捷键
SPACE cycle pause
RIGHT seek 10
LEFT seek -10

常用配置示例

视频配置

# 使用 GPU 硬件解码
hwdec=auto

# 视频输出驱动
vo=gpu

# 视频渲染质量
profile=gpu-hq

# 色彩管理
icc-profile-auto=yes

音频配置

# 音频输出驱动
ao=wasapi

# 默认音量
volume=80

# 音频标准化
audio-normalize-downmix=yes

# 音频延迟
audio-delay=0

字幕配置

# 字幕字体
sub-font="Noto Sans CJK SC"

# 字幕大小
sub-font-size=40

# 字幕颜色
sub-color="#FFFFFFFF"

# 字幕阴影
sub-shadow-color="#80000000"
sub-shadow-offset=2

界面配置

# 窗口标题
title="${media-title}"

# OSC 样式
osc=yes

# 进度条样式
osd-bar=yes

# 状态信息
osd-level=1

配置文件优先级

mpv 按以下优先级加载配置：

1. 命令行选项（最高优先级）
2. 用户配置文件
3. 系统配置文件
4. 默认值（最低优先级）

配置文件目录

除了主配置文件外，mpv 还使用以下目录：

脚本目录

• Windows: %APPDATA%/mpv/scripts/
• macOS: ~/.config/mpv/scripts/
• Linux: ~/.config/mpv/scripts/

字体目录

• Windows: %APPDATA%/mpv/fonts/
• macOS: ~/.config/mpv/fonts/
• Linux: ~/.config/mpv/fonts/

缓存目录

• Windows: %LOCALAPPDATA%/mpv/
• macOS: ~/.cache/mpv/
• Linux: ~/.cache/mpv/

配置文件编码

配置文件应使用 UTF-8 编码。在 Windows 上，建议使用支持 UTF-8 的文本编辑器（如 VS Code、Notepad++）。

配置文件调试

查看当前配置

mpv --show-profile=gpu-hq

验证配置文件

mpv --config-files-only video.mp4

查看所有选项

mpv --list-options

下一步

• 视频输出 - 视频输出配置详解
• 音频输出 - 音频输出配置详解
• 选项参考 - 所有可用选项