参考手册
CLI 选项速查
yt-dlp 命令行选项完整速查表
这里列出最常用的选项。完整选项请运行 yt-dlp --help 或查看
官方文档。
通用选项
| 选项 | 说明 |
|---|---|
-h, --help | 显示帮助信息 |
--version | 显示版本号 |
-U, --update | 更新到最新版本 |
--ignore-errors, -i | 忽略下载错误，继续处理 |
--abort-on-error | 遇到错误立即中止 |
--no-overwrites | 不覆盖已存在的文件 |
-q, --quiet | 静默模式，不输出信息 |
-v, --verbose | 详细输出（调试用） |
网络选项
| 选项 | 说明 |
|---|---|
--proxy URL | 使用代理 |
--socket-timeout SEC | 网络超时秒数 |
--source-address IP | 绑定到指定 IP |
-4, --force-ipv4 | 强制 IPv4 |
-6, --force-ipv6 | 强制 IPv6 |
下载选项
| 选项 | 说明 |
|---|---|
-r, --limit-rate RATE | 限制下载速度（如 10M、500K） |
-R, --retries N | 重试次数（默认 10） |
--fragment-retries N | 分段重试次数 |
-c, --continue | 断点续传 |
-N, --concurrent-fragments N | 并发下载分段数 |
格式选择
| 选项 | 说明 |
|---|---|
-f, --format FORMAT | 格式选择字符串 |
-F, --list-formats | 列出可用格式 |
-S, --format-sort KEYS | 格式排序规则 |
--merge-output-format FMT | 合并输出格式（mp4/mkv/webm） |
字幕选项
| 选项 | 说明 |
|---|---|
--write-sub | 下载字幕 |
--write-auto-sub | 下载自动生成字幕 |
--all-subs | 下载所有字幕 |
--list-subs | 列出可用字幕 |
--sub-lang LANGS | 字幕语言（逗号分隔） |
--sub-format FMT | 字幕格式 |
--embed-subs | 嵌入字幕到视频 |
--convert-subs FMT | 转换字幕格式 |
认证选项
| 选项 | 说明 |
|---|---|
--cookies FILE | Cookies 文件路径 |
--cookies-from-browser BROWSER | 从浏览器提取 cookies |
-u, --username USER | 用户名 |
-p, --password PASS | 密码 |
后处理选项
| 选项 | 说明 |
|---|---|
-x, --extract-audio | 提取音频 |
--audio-format FMT | 音频格式（mp3/m4a/flac/opus/wav） |
--audio-quality Q | 音频质量（0 最好，10 最差，或 320K） |
--embed-thumbnail | 嵌入缩略图 |
--add-metadata | 添加元数据 |
--recode-video FMT | 转换视频格式 |
-k, --keep-video | 后处理后保留原始文件 |
输出模板
| 选项 | 说明 |
|---|---|
-o, --output TMPL | 输出文件名模板 |
-P, --paths DIR | 下载目录 |
--restrict-filenames | 限制文件名为 ASCII 字符 |
--windows-filenames | 强制 Windows 兼容文件名 |
播放列表选项
| 选项 | 说明 |
|---|---|
-I, --playlist-items ITEMS | 选择播放列表项（如 1:5） |
--no-playlist | 不按播放列表处理 |
--yes-playlist | 作为播放列表处理 |
--download-archive FILE | 下载归档文件 |
信息提取
| 选项 | 说明 |
|---|---|
-j, --dump-json | 输出 JSON 信息 |
--print FIELD | 打印指定字段 |
--skip-download | 不下载，只提取信息 |
--no-check-certificates | 跳过 SSL 证书验证 |
批量下载
| 选项 | 说明 |
|---|---|
-a, --batch-file FILE | 从文件读取 URL |
--sleep-interval SEC | 下载间隔秒数 |
--max-sleep-interval SEC | 最大随机间隔 |
--sleep-requests SEC | 请求间隔 |
SponsorBlock
| 选项 | 说明 |
|---|---|
--sponsorblock-mark CATS | 标记赞助片段 |
--sponsorblock-remove CATS | 删除赞助片段 |
--no-sponsorblock | 禁用 SponsorBlock |