youtube-dl：命令行视频下载工具

项目简介

youtube-dl 是一个命令行程序，用于从 YouTube.com 以及其他若干视频网站下载视频。它需要 Python 解释器（2.6、2.7 或 3.2 及以上版本），不依赖特定平台，可在 Unix、Windows 和 macOS 上运行。项目以公有领域发布，可以自由修改、再分发或按需使用。

基本用法：

youtube-dl [OPTIONS] URL [URL...]

主要功能

• 从 YouTube 及大量其他视频站点下载视频，可用 --list-extractors 查看全部支持的站点提取器，用 --extractor-descriptions 输出各提取器说明。
• 提供丰富的命令行选项，例如 -h/--help 查看帮助、--version 查看版本、-U/--update 更新程序。
• 错误处理：-i/--ignore-errors 在下载出错时继续（例如跳过播放列表中不可用的视频），--abort-on-error 则在出错时中止后续下载。
• 播放列表相关：--flat-playlist 只列出播放列表中的视频而不提取。
• 网络选项：--proxy URL 指定 HTTP/HTTPS/SOCKS 代理（例如 socks5://127.0.0.1:1080/），--socket-timeout SECONDS 设置超时，--source-address IP 绑定客户端地址，-4/--force-ipv4、-6/--force-ipv6 强制使用 IPv4 或 IPv6。
• 地区限制处理：--geo-bypass 通过伪造 X-Forwarded-For 请求头绕过地理限制，--geo-bypass-country CODE 指定两位 ISO 3166-2 国家代码，--geo-bypass-ip-block IP_BLOCK 指定 CIDR 格式的 IP 段，--geo-verification-proxy URL 指定用于验证 IP 的代理。
• 配置文件支持：默认读取配置文件，可用 --ignore-config 忽略，或用 --config-location PATH 指定配置文件路径。
• 其他选项：--default-search PREFIX 为不完整 URL 设置搜索前缀，--mark-watched / --no-mark-watched 控制是否标记为已观看（仅 YouTube），--no-color 关闭彩色输出。

安装与使用

Unix 用户（Linux、macOS 等）可直接下载可执行文件：

sudo curl -L https://yt-dl.org/downloads/latest/youtube-dl -o /usr/local/bin/youtube-dl
sudo chmod a+rx /usr/local/bin/youtube-dl

没有 curl 时可用 wget：

sudo wget https://yt-dl.org/downloads/latest/youtube-dl -O /usr/local/bin/youtube-dl
sudo chmod a+rx /usr/local/bin/youtube-dl

也可以通过 pip 安装或升级：

sudo -H pip install --upgrade youtube-dl

macOS 用户还可以使用 Homebrew 或 MacPorts：

brew install youtube-dl
sudo port install youtube-dl

Windows 用户可下载 .exe 文件，放到 PATH 中的任意位置，但不要放在 %SYSTEMROOT%\System32（例如不要放入 C:\Windows\System32）。

更多下载方式（包括 PGP 签名）参见项目的下载页面。

注意事项

• 2021.12.17 版本已较旧，存在许多已知问题；官方建议改用 nightly 构建版本，该版本基于仓库的 master 分支生成。
• 使用 -U/--update 更新程序时需要足够的权限，必要时用 sudo 运行。
• 在全局配置文件 /etc/youtube-dl.conf 中使用 --ignore-config 时，不会读取用户配置（Windows 上位于 %APPDATA%/youtube-dl/config.txt，其他平台位于 ~/.config/youtube-dl/config）。
• 资料中未提供图形界面，本项目为纯命令行工具。

---

本作品整理自 GitHub 开源项目 ytdl-org/youtube-dl，原作者 @ytdl-org，许可证 Unlicense。中文介绍由 AI 根据项目 README 整理，以原仓库为准。