在 macOS 上安装 yt-dlp 以及其 详细使用教程（含命令示例）

下面是 在 macOS 上安装 yt-dlp 以及其 详细使用教程（含命令示例），适合入门到进阶用户：

---

✅ 一、在 macOS 上安装 yt-dlp

方式一：使用 Homebrew（推荐）

brew install yt-dlp

更新：

brew upgrade yt-dlp

方式二：直接下载官方预编译版本

# 下载并赋予可执行权限
curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
chmod a+rx /usr/local/bin/yt-dlp

✅ 检查安装：

yt-dlp --version

---

🚀 二、基本使用示例

下载单个视频

yt-dlp https://www.youtube.com/watch?v=xxxxxx

自定义输出文件名

yt-dlp -o "%(title)s.%(ext)s" https://www.youtube.com/watch?v=xxxxxx

仅下载音频（mp3 格式）

yt-dlp -x --audio-format mp3 https://www.youtube.com/watch?v=xxxxxx

下载整个播放列表

yt-dlp https://www.youtube.com/playlist?list=xxxxxx

---

🎯 三、进阶功能

选择视频清晰度（比如只下载 720p）

yt-dlp -f "bestvideo[height<=720]+bestaudio/best[height<=720]" URL

自动添加上传日期到文件名

yt-dlp -o "%(upload_date)s - %(title)s.%(ext)s" URL

使用 cookies（应对登录/年龄限制视频）

yt-dlp --cookies cookies.txt URL

👉 使用浏览器插件如 EditThisCookie 导出 cookies。

---

🔧 四、配置文件（自动化常用参数）

你可以在 ~/.config/yt-dlp/config 或 ~/.yt-dlp.conf 添加常用设置：

例如：

# 下载音频
-x
--audio-format mp3
-o ~/Downloads/%(title)s.%(ext)s
--embed-thumbnail

---

🧰 五、常用命令速查表

功能	命令示例
下载音频（MP3）	yt-dlp -x --audio-format mp3 URL
限制视频分辨率	yt-dlp -f "bv[height<=720]+ba/b[height<=720]" URL
下载字幕	yt-dlp --write-subs --sub-lang en URL
跳过已下载	yt-dlp --download-archive downloaded.txt URL
合并格式失败时保留文件	yt-dlp --keep-video
设置代理	yt-dlp --proxy socks5://127.0.0.1:1080 URL

---

📚 官方文档资源

• GitHub: https://github.com/yt-dlp/yt-dlp
• 使用手册: yt-dlp --help
• Wiki: https://github.com/yt-dlp/yt-dlp/wiki

---

经常下载 YouTube、Bilibili、TikTok 的视频，提供一个完整的 yt-dlp 使用配置模板 + 常用命令合集，让你高效、一键式使用。

---

✅ 一、推荐配置文件模板

你可以把下面内容保存为配置文件：

# 配置文件位置（任选其一）：
~/.config/yt-dlp/config
~/.yt-dlp.conf

📄 推荐内容：

# 通用设置
-o ~/Downloads/%(uploader|channel)s/%(title)s [%(id)s].%(ext)s
--embed-thumbnail
--add-metadata
--merge-output-format mp4
--write-info-json

# 自动转换音频（如仅下载音频时）
--audio-quality 0

# 下载字幕（如有）
--write-auto-sub
--sub-lang zh,en
--embed-subs

# 跳过重复内容
--download-archive ~/.yt-dlp-archive.txt

# 最高画质优先（可选）
-f "bv*+ba/b"

# 错误自动重试
--retries 10
--fragment-retries 10

# 日志简洁
--no-warnings
--quiet

---

🚀 二、各站点常用命令

🔴 YouTube

下载高清视频 + 自动加字幕

yt-dlp "https://www.youtube.com/watch?v=xxxxxx"

下载整个播放列表（例如频道更新合集）

yt-dlp "https://www.youtube.com/playlist?list=xxxxxx"

下载为音频（MP3）

yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=xxxxxx"

---

🟡 Bilibili（支持番剧、合集、音频）

下载视频（单个或合集）

yt-dlp "https://www.bilibili.com/video/BVxxxxxx"

下载弹幕（可用）

yt-dlp --write-comments "https://www.bilibili.com/video/BVxxxxxx"

下载番剧全集（EP合集）

yt-dlp "https://www.bilibili.com/bangumi/play/ep123456"

⚠️ 如果提示地区限制，可配合 --proxy 选项使用代理。

---

🟣 TikTok（包含无水印下载）

下载单条视频

yt-dlp "https://www.tiktok.com/@username/video/xxxxxx"

下载用户主页所有视频

yt-dlp "https://www.tiktok.com/@username"

⚠️ 有些 TikTok 页面需要模拟登录，可搭配 cookies 文件使用：

yt-dlp --cookies cookies.txt "https://www.tiktok.com/@username"

---

🔧 三、实用技巧

设置代理（应对墙/加速访问）

yt-dlp --proxy socks5://127.0.0.1:1080 URL

使用 cookies.txt（登录验证、解除限制）

yt-dlp --cookies cookies.txt URL

只列出视频信息（不下载）

yt-dlp -F URL

---

📁 四、文件自动归类结构（根据配置）

例如：

~/Downloads/
├── YouTube/
│   ├── MKBHD/
│   │   └── Apple iPhone Review [abc123].mp4
├── Bilibili/
│   └── 老番茄/
├── TikTok/
│   └── @somegirl/

---

如果你希望我 为三大平台写一个统一下载脚本 或者 自动批量处理脚本（如拖 URL 文件夹自动下载），也可以直接告诉我 ✅

是否要我帮你生成一个一键下载脚本？