如何使用yt-dlp下载YouTube视频

### 如何使用 yt-dlp 下载 YouTube 视频 #### 准备工作 为了顺利运行 `yt-dlp`，需确认已安装 Python 版本不低于 3.7，并建议一并部署 FFmpeg 和 ffprobe 工具以便于后期处理视频文件[^2]。 #### 安装 yt-dlp 可以通过 pip 命令轻松安装最新版本的 `yt-dlp`： ```bash pip install yt-dlp ``` #### 编写下载脚本 下面提供了一个简单的 Python 脚本来展示如何利用 `yt-dlp` 来获取指定 URL 的 YouTube 视频。此代码片段定义了名为 `download_video()` 的函数，接受两个参数——目标链接 (`url`) 及保存路径模式 (`output_path`)；默认情况下会依据最佳质量自动选择音频流或视频流进行下载[^4]。 ```python import yt_dlp def download_video(url, output_path='%(title)s.%(ext)s'): ydl_opts = { 'format': 'bestvideo+bestaudio/best', 'outtmpl': output_path, } with yt_dlp.YoutubeDL(ydl_opts) as ydl: ydl.download([url]) # 使用示例 video_url = 'https://www.youtube.com/watch?v=dQw4w9WgXcQ' download_video(video_url) ``` 上述例子中设置了 `'format': 'bestvideo+bestaudio/best'` 参数组合，旨在优先选取最高画质与独立的最佳音轨相结合的方式完成下载任务，如果无法满足条件则退而求其次采用单一最优格式。 #### 实现带进度条的功能 对于希望实时跟踪下载状态的应用场景而言，在原有基础上稍作修改即可引入进度显示机制。通过向选项字典内加入回调钩子 (progress_hooks)，每当有新的进展发生时都会触发相应的事件处理器来刷新 UI 上的状态指示器[^3]。 ```python from tqdm import tqdm class MyProgressBar(tqdm): def update_to(self, b=1, bsize=1, tsize=None): if tsize is not None: self.total = tsize self.update(b * bsize - self.n) def my_hook(d): if d['status'] == 'downloading': filename = d.get('_filename') total_bytes = int(d.get('total_bytes_estimate')) downloaded_bytes = int(d.get('downloaded_bytes')) pbar = MyProgressBar(total=total_bytes, unit='B', unit_scale=True, desc=f'Downloading {filename}') pbar.update(downloaded_bytes) ydl_opts = { 'format': 'bestvideo+bestaudio/best', 'outtmpl': '%(title)s.%(ext)s', 'progress_hooks': [my_hook], } with yt_dlp.YoutubeDL(ydl_opts) as ydl: ydl.download(['https://www.youtube.com/watch?v=dQw4w9WgXcQ']) ``` 这段增强后的代码实现了更加友好的用户体验，允许用户直观地看到当前操作的具体情况和发展趋势。

### 解决 yt-dlp 下载 YouTube 视频时出现的 403 错误 当使用 `yt-dlp` 下载 YouTube 视频时遇到 403 错误，这通常意味着服务器拒绝请求。这种错误可能由多种原因引起，包括但不限于 IP 地址被封禁、用户代理不兼容或 cookies 过期等问题。 #### 更新到最新版本 确保使用的 `yt-dlp` 版本是最新的非常重要，因为开发者会定期修复 bug 并增加新特性来应对不断变化的服务端策略[^1]。 ```bash pip install --upgrade yt-dlp ``` #### 使用自定义 User-Agent 和 Cookies 文件 有时更改默认的 HTTP 请求头中的 user-agent 字段可以帮助绕过某些限制。另外，如果目标网站依赖于登录状态或其他 session 数据，则可以通过传递有效的 cookie 来解决问题。 ```bash yt-dlp -U https://www.youtube.com/watch?v=example_video_id \ --user-agent "Mozilla/5.0 (Windows NT 10.0; Win64; x64)" \ --cookies ./path_to_cookies.txt ``` #### 尝试不同的网络环境 如果怀疑是因为本地 IP 被封锁而导致的问题，那么可以尝试通过其他网络连接再次发起请求，比如切换 Wi-Fi 或者使用虚拟专用网(VPN)[^2]。 #### 添加额外参数优化下载过程 对于特定情况下的问题，还可以考虑加入更多选项来自定义行为： - `-v`: 增加日志输出级别以便更好地理解发生了什么； - `--no-check-certificate`: 如果 SSL/TLS 验证失败的话忽略证书验证； - `--proxy http://your_proxy_address:port`: 当需要经过代理服务器访问互联网资源的时候指定代理地址； ```bash yt-dlp -v --no-check-certificate --proxy socks5://localhost:9050 https://www.youtube.com/watch?v=example_video_id ```