PyTube Downloader快速上手教程:从安装到下载第一个视频的5个步骤

原创2026-11-03 18:18:131,871 阅读

PyTube Downloader快速上手教程:从安装到下载第一个视频的5个步骤

PyTube Downloader(PyTube 下载器)是一款简单、快速、强大的 YouTube 视频下载工具,支持 Mac、Windows 和 Linux,可下载 144p–8K 多种质量、MP4/MP3 等格式的单个视频或整个播放列表。本教程用 5 个步骤带你完成 YouTube 下载器安装,并成功下载第一个视频。


步骤 1:获取 PyTube Downloader 源代码

打开终端,克隆项目仓库:

git clone https://gitcode.com/gh_mirrors/pytu/pytube-downloader
cd pytube-downloader

💡 项目要求 Python 3.10+,请先确认本机已安装 Python。

步骤 2:安装 FFmpeg(视频下载器必备)

FFmpeg 负责视频/音频的合并与转换,是下载高清视频的关键。

  1. 从 FFmpeg 官网下载并解压
  2. 将 ffmpeg.exe 复制到项目的 ffmpeg/ 目录中

该目录会随项目一起分发,放进去即可,无需配置环境变量。

步骤 3:一键安装 Python 依赖

项目提供了自动安装脚本 dependencies_installer.py,在终端执行:

python dependencies_installer.py          # 核心依赖
python dependencies_installer.py windows  # Windows 用户:额外安装通知相关组件

它会按照 requirements.txt 自动安装 customtkinter、pytubefix、pillow 等依赖库,无需手动 pip install。

步骤 4:启动 PyTube Downloader

运行主入口 main.py:

python main.py

首次启动后,程序会自动加载主题、语言和设置(默认配置见 data/general.json)。启动后你会看到类似下图的主界面,顶部是链接输入栏,下方分为「已添加 / 下载中 / 已下载 / 历史」四个标签页:

![PyTube Downloader 主界面:粘贴 YouTube 链接并添加视频到下载列表](https://raw.gitcode.com/gh_mirrors/pytu/pytube-downloader/raw/aeed4aec072afa9bd396e55598b2e18f3fa4c1e8/readme assets/zh-0.png?utm_source=gitcode_repo_files)

🎨 不喜欢默认外观?按 Ctrl + , 打开设置,在「外观」页可切换主题、强调色、窗口比例与透明度:

![PyTube 下载器外观设置:主题与强调色选择界面](https://raw.gitcode.com/gh_mirrors/pytu/pytube-downloader/raw/aeed4aec072afa9bd396e55598b2e18f3fa4c1e8/readme assets/zh-5.png?utm_source=gitcode_repo_files)

步骤 5:下载你的第一个视频

整个下载流程只需 4 次点击:

  1. 粘贴链接:把 YouTube 视频或播放列表链接粘贴到顶部输入栏
  2. 选择模式:勾选「视频」(单个视频)或「播放列表」(整列表下载)
  3. 点击「添加」:应用会自动加载视频信息,包括标题、频道、缩略图
  4. 选择质量并下载:在下拉框中选择格式与质量(144p–8K、MP4、MP3 等),点击「下载」,即可在「下载中」页实时查看进度和速度

![PyTube 下载器下载中界面:实时显示下载进度与速度](https://raw.gitcode.com/gh_mirrors/pytu/pytube-downloader/raw/aeed4aec072afa9bd396e55598b2e18f3fa4c1e8/readme assets/zh-1.png?utm_source=gitcode_repo_files)

下载完成后,视频会出现在「已下载」页,点击文件夹图标可直接打开文件所在目录,点击播放按钮可立即播放:

![PyTube 下载器已下载页面:管理已下载的 YouTube 视频文件](https://raw.gitcode.com/gh_mirrors/pytu/pytube-downloader/raw/aeed4aec072afa9bd396e55598b2e18f3fa4c1e8/readme assets/zh-2.png?utm_source=gitcode_repo_files)


实用设置推荐


常见问题

问题 解决方法
启动报错缺少模块 重新运行 python dependencies_installer.py
高清视频下载失败/无声音 检查 ffmpeg/ 目录中是否已放入 ffmpeg.exe
界面是英文 设置 → 通用 → 语言切换为中文(支持中、英、僧加罗语、泰米尔语、俄语)

项目结构速览

想深入了解?核心逻辑位于 services/(下载、历史、主题管理等)和 widgets/(界面组件),完整目录说明见 PROJECT_STRUCTURE.md。

⚠️ 本应用仅供个人使用,下载视频时请遵守 YouTube 服务条款并尊重内容创作者的版权。

完成以上 5 个步骤,你就已经掌握了这款 YouTube 下载器的核心用法——粘贴链接、选择质量、点击下载,简单快速又强大!

登录后查看全文
pytube-downloader