抖音视频下载工具（中学生也能看懂版）
这个工具能做什么？
帮你下载抖音上的视频！支持两种方式：
- 下载推荐页视频 - 就像你打开抖音看到的首页视频流
- 下载某个博主的主页视频 - 下载你喜欢的博主发布的视频
你需要准备什么？
- 一台 Mac 电脑
- 已经下载了这个项目到本地
- 一点点耐心（需要手动登录抖音）
重要提醒
- 不能自动登录抖音（需要你手动扫码或输入密码）
- 不能自动过验证码（遇到验证码需要你自己点）
- 只能下载当前页面上已经显示的视频（不会自动翻页下载全部历史视频）
第一次使用（安装环境）
打开终端（Terminal），依次输入以下命令：
# 1. 进入项目文件夹
cd /你的项目目录/douyin-crawler-poc
# 2. 创建虚拟环境（隔离项目依赖）
python3 -m venv .venv
# 3. 激活虚拟环境
source .venv/bin/activate
# 4. 安装需要的库
pip install requests DrissionPage
什么是虚拟环境？ 就像给这个项目建了一个独立的房间，里面放的工具不会影响电脑其他地方。
使用方法一：下载推荐页视频（首页视频流）
步骤 1：启动浏览器并登录抖音
./.venv/bin/python login_douyin.py
运行后会发生什么：
- 会自动打开 Chrome 浏览器
- 浏览器会显示抖音登录页面
- 你需要手动登录（扫码或输入账号密码）
- 如果遇到验证码，也需要手动完成
步骤 2：下载视频
登录成功后，在终端输入：
# 下载默认数量（50个视频）
./.venv/bin/python Douyin.py
# 或者只下载10个视频
./.venv/bin/python Douyin.py --max-videos 10
# 或者只下载3个视频（测试用）
./.venv/bin/python Douyin.py --max-videos 3
注意： 下载前请确保浏览器显示的是抖音推荐页（就是打开抖音看到的第一个页面，有很多视频往下滚动的那种）。
使用方法二：下载某个博主的主页视频
步骤 1：同样先启动浏览器并登录
./.venv/bin/python login_douyin.py
步骤 2：进入博主主页
在浏览器中：
- 搜索你想下载的博主（比如某个美食博主）
- 点击进入他的主页
- 等待页面加载完成（看到博主的视频列表）
步骤 3：下载视频
在终端输入：
# 下载当前页面显示的视频（默认只下载当前页）
./.venv/bin/python Douyin.py
# 或者下载多页（自动向下滚动加载）
./.venv/bin/python Douyin.py --pages 3
注意： --pages 3 表示滚动加载3页，但抖音可能会限制，不一定能下载到那么多。
方法三：直接下载单个视频
如果你只想下载某一个具体的视频：
# 方法 A：通过视频链接下载
./.venv/bin/python Douyin.py "https://www.douyin.com/video/视频ID"
# 方法 B：直接通过视频ID下载
./.venv/bin/python Douyin.py "7619989983668240802"
下载的视频在哪里？
所有下载的视频都会保存在项目文件夹里的 video/ 文件夹中。
文件名格式：
[博主昵称]视频标题-视频ID.mp4
例如：
[小张一人食]花2XXX在汕头喝白粥...-7633717884061725297.mp4
[相声老司机]春晚不好看？...-7606185972144901412.mp4
常见问题
Q1：运行时报错 "缺少 requests" 或 "缺少 DrissionPage"
解决： 没有安装依赖，运行：
pip install requests DrissionPage
Q2：提示 "当前页面不是受支持的抖音页面"
解决：
- 如果要用推荐页：确保浏览器显示的是抖音首页（有视频流往下滚动的页面）
- 如果要用博主页：确保你在某个博主的主页
Q3：下载了0个视频
解决：
- 检查是否已登录抖音
- 检查当前页面是否有视频显示
- 等待页面完全加载后再运行下载命令
Q4：Chrome 浏览器没打开
解决：
- 确保你用的是 Mac
- 确保已安装 Google Chrome
- 检查是否有其他 Chrome 正在运行，先关闭再试
Q5：我想下载更多视频怎么办？
推荐页：
./.venv/bin/python Douyin.py --max-videos 100
博主页：
./.venv/bin/python Douyin.py --pages 5
所有可用命令汇总
# 查看所有参数说明
./.venv/bin/python Douyin.py --help
# 推荐页下载（默认50个）
./.venv/bin/python Douyin.py
# 推荐页下载（指定数量）
./.venv/bin/python Douyin.py --max-videos 20
# 博主页下载（默认当前页）
./.venv/bin/python Douyin.py
# 博主页下载（多页）
./.venv/bin/python Douyin.py --pages 3
# 单视频下载
./.venv/bin/python Douyin.py "https://www.douyin.com/video/xxx"
# 修改等待时间（如果网络慢）
./.venv/bin/python Douyin.py --timeout 20
# 修改保存位置
./.venv/bin/python Douyin.py --output-dir 我的视频
详细图文教程
如果你还是不太明白，可以查看这份更详细的图文教程：
技术说明（给感兴趣的同学）
这个工具使用了两步式工作流：
- login_douyin.py - 启动带调试端口的 Chrome，让你手动登录
- Douyin.py - 附着到已登录的浏览器，监听抖音的 API 请求，提取视频地址并下载
为什么需要手动登录？因为抖音有反爬虫机制，自动登录容易被封。
免责声明
本工具仅供学习交流使用，请勿用于商业用途或侵犯他人权益。下载的视频版权归原博主所有。