1. 安装方法
系统要求:
- 支持 Windows/macOS/Linux
- 需要 Python 环境(推荐 Python 3.6+)
安装步骤:
Ubuntu/Debian:
sudo apt-get install youtube-dl # 通过包管理器安装(可能版本较旧)
# 或使用 pip 安装最新版
sudo apt-get install python3-pip
sudo pip3 install --upgrade youtube-dl
macOS:
brew install youtube-dl # 通过 Homebrew 安装
# 或使用 pip
pip3 install youtube-dl
Windows:
- 安装 Python 并确保勾选
Add Python to PATH
。
- 打开命令提示符(CMD):
pip install youtube-dl
2. 基本用法
下载单个视频:
youtube-dl "视频URL"
# 示例:
youtube-dl https://www.youtube.com/watch?v=dQw4w9WgXcQ
选择视频格式:
列出所有可用格式:
youtube-dl -F "URL"
# 输出示例:
# format code extension resolution note
# 137 mp4 1920x1080 1080p, video only
# 140 m4a audio only
3. 高级功能
下载播放列表:
youtube-dl --yes-playlist "播放列表URL"
# 限制下载数量(例如前5个视频):
youtube-dl --playlist-items 1-5 "URL"
下载字幕和元数据:
youtube-dl --write-sub --write-auto-sub "URL" # 自动生成字幕(如果有)
youtube-dl --write-sub --sub-lang zh-Hans,en "URL" # 指定中英文字幕
youtube-dl --write-thumbnail # 下载缩略图
代理设置(适用于网络受限地区):
youtube-dl --proxy http://127.0.0.1:1080/ "URL"
自定义输出路径和文件名:
youtube-dl -o "/path/to/save/%(title)s.%(ext)s" "URL"
4. 常见问题解决
错误处理:
无法下载:
- 更新到最新版本:
youtube-dl --update
- 尝试添加
--ignore-errors
跳过错误。
视频被加密(DRM):
youtube-dl
无法下载受 DRM 保护的视频(如 Netflix)。
网络问题:
5. 注意事项
示例命令合集
# 下载 1080p 视频并合并音频
youtube-dl -f 'bestvideo[height<=1080]+bestaudio' "URL"
# 下载播放列表并保存到指定文件夹
youtube-dl -o "~/Downloads/%(playlist)s/%(title)s.%(ext)s" --yes-playlist "URL"
# 批量下载文本文件中的链接
youtube-dl -a links.txt
通过以上步骤,你可以高效使用 youtube-dl
下载和管理视频内容。遇到问题时,可通过 youtube-dl --help
查看完整选项。