TikTokDownloader 教程：3 条命令批量下载抖音/TikTok 视频
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
收藏刷到的作品：把链接变成本地文件
想在手机里留存一条抖音或 TikTok 作品，官方 App 却没有下载入口。TikTokDownloader 是一款免费开源的抖音 / TikTok 视频下载与数据采集工具，面向想批量保存作品、整理素材的新手和普通用户：本地运行后粘贴作品链接，视频文件即自动落盘，也支持整页账号作品批量下载。
3 条命令完成安装与启动
git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader执行后你会看到项目源码完整拉取到本地，当前目录下生成一个 TikTokDownloader 文件夹。
cd TikTokDownloader && uv sync --no-dev执行后你会看到 uv 逐个安装依赖包，完成后生成 .venv 虚拟环境，无需手动创建。
uv run main.py执行后你会看到终端先展示免责声明，随后进入功能选择菜单；首次运行会在项目根目录生成 settings.json，并提示你写入 Cookie 后才能正常工作。
三条常用任务：从链接到本地目录
粘贴链接下载单个视频
- 在主菜单选择「终端交互模式」→「批量下载链接作品(抖音)」。
- 输入作品链接（支持一次粘贴多条），按回车开始。
- 终端实时显示下载进度，完成后视频保存在项目根目录的 Download 文件夹中，文件名按「时间-昵称-描述」规则生成。
批量下载账号主页全部作品
- 在 settings.json（首次运行自动生成的本地配置文件）的 accounts_urls 中填入账号主页链接，也可以直接在菜单中粘贴。
- 选择「批量下载账号作品(抖音)」，程序自动翻页抓取作品。
- 产出是按账号归档的独立子目录；程序会记录已下载作品 ID，再次运行自动跳过旧文件，实现增量更新。
把下载能力挂成 HTTP 接口
- 主菜单选择「Web API 模式」。
- 浏览器访问
http://127.0.0.1:5555/docs，即可看到自动生成的接口文档。 - 在自己的脚本或应用里直接调用接口，完成自动化采集与下载流程。
修改 settings.json 里最常用的 4 项
| 配置项 | 作用 | 推荐值 |
|---|---|---|
| cookie | 抖音平台访问凭证，直接影响数据获取与视频清晰度 | 失效后按教程重新写入 |
| root | 作品文件的保存根目录 | 指向一个方便备份的本地目录 |
| name_format | 文件名拼接规则，可选时间、昵称、描述等字段 | 默认的 create_time type nickname desc |
| max_size | 单文件大小上限，超出的文件不下载 | 0 表示不限制 |
修改后需重启程序才会生效；若配置里缺少新增的键，程序读取时会自动补齐并提示。
3 个新手高频问题：现象、原因、解决
现象：首次运行只提示"创建默认配置文件成功"，未进入菜单。原因：未写入 Cookie 时程序不具备采集条件，会直接退出。解决：按 Cookie 获取教程 在浏览器中复制 Cookie，运行程序选择「手动输入 Cookie」粘贴即可。
现象：提示数据获取失败，或下载到的视频清晰度明显偏低。原因：Cookie 过期或登录态失效；私密账号还需要已登录且已关注该账号的 Cookie。解决：重新执行 Cookie 获取步骤更新配置；仍失败时检查网络或为 settings.json 配置 proxy 代理。
现象：手改 settings.json 后，程序提示"JSON 格式错误"或配置不生效。原因：手动编辑漏掉逗号或引号导致解析失败，程序回退到默认配置。解决：用 JSON 校验工具检查语法，修改完成后重启程序再试。
从文档到源码：找资源的 3 个入口
- README.md：完整功能列表、Docker 部署与程序更新说明
- docs/Cookie获取教程.md：浏览器获取有效 Cookie 的分步演示
- encipher_example.py：加密参数生成代码的配置示例
Cookie 写入后就可以开工了，下一条想收藏的作品，直接粘贴链接试试。
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
