一篇文章搞定 B 站 4K 视频下载bilibili-downloader 离线备份实战指南【免费下载链接】bilibili-downloaderB站视频下载支持下载大会员清晰度4K持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloaderbilibili-downloader 是一个用 Python 编写的开源 B 站视频下载工具核心能力一句话就能说清把普通视频、分 P 合集、充电专属内容以及大会员限定的 4K 画质一键保存为本地文件。项目入口脚本为 main.py所有个性化设置集中在 config.pyREADME.md 里也有完整的功能清单与运行说明。开篇你只是租了这些视频而不是买了它们先算一笔账你在 B 站花无数个深夜追完的系列课程、收藏夹里反复重温的演唱会、跟着做笔记的教程合集——这些内容真正属于你的有多少现实往往是残酷的。UP 主可能因为某些原因清空投稿版权方到期可能让整部作品下架平台的缓存也会随着登录状态失效而灰飞烟灭。你在视频平台看到的每一个视频本质上都只是一份租来的观看许可平台随时可以收回。想要真正把内容握在自己手里唯一的办法就是趁还能访问时把它下载到自己的硬盘上。bilibili-downloader 就是为此而生的。先花 30 秒认识它能下载什么不能下载什么整个使用流程可以压缩成一条流水线粘贴链接 → 自动识别视频类型 → 请求账号可用最高画质 → 并行拉取音视频 → 自动合成 → 存入本地目录具体能力盘点如下覆盖主流内容形态普通视频、分 P 合集、充电专属视频统统支持4K 画质可达配合大会员账号的 Cookie能拿到账号权限内的最高清晰度批量排队下载多个链接一次扔进去自动逐个处理不用守着点异步并发加速视频与音频并行拉取比顺序下载快得多进度条 自动重试全程可视化中断后可续传网络波动会自动兜底音视频自动合并下载完直接合成一个文件开箱即播失败自动留痕下载失败的链接会被写入failed_urls.txt方便之后重试需要注意的边界番剧、纪录片目前标注为待测试且需要中国大陆 IP代理功能也在开发计划中。从零跑通四步完成你的第一次下载第 1 步拉取代码并安装依赖约 2 分钟打开终端依次执行git clone https://gitcode.com/gh_mirrors/bil/bilibili-downloader cd bilibili-downloader pip install -r requirements.txt依赖总共只有 4 个全部轻量httpx异步网络请求、beautifulsoup4页面解析、moviepy音视频合并、tqdm进度条渲染。第 2 步把登录凭证放进 config.py约 3 分钟最关键为什么必须配置 Cookie可以这样理解B 站把画质权限和账号绑定工具只有带着你的登录凭证去请求B 站才会把你账号有资格看的最高画质比如 4K开放给它。没有这串凭证最多只能拿到游客画质。获取凭证的完整路径如下用浏览器登录 B 站随便打开一个视频页面按下 F12或右键选择检查切换到网络标签页刷新页面点开第一个请求在请求头里找到cookie字段复制整段值其中就包含身份标识SESSDATA打开项目根目录的config.py把复制的内容粘贴到COOKIE参数中小提示Cookie 的有效期大约 30 天过期后按同样的步骤重新复制一次即可平时无需改动。第 3 步把想下载的链接填进 URL 列表约 1 分钟打开config.py把链接写进URL列表URL [ https://www.bilibili.com/video/BV1AAAA1111/, # 普通视频 https://www.bilibili.com/video/BV1BBBB2222/?p2, # 分P视频第2集 https://www.bilibili.com/video/BV1CCCC3333/, # 充电专属视频 ]第 4 步运行并等待成品约 5 分钟python main.py终端会依次显示视频标题、清晰度、音频与视频各自的下载进度条下载完成后自动进入合并环节成品最终落在output/目录。整个过程可以参考下面的运行动图收尾时程序还会输出一份下载摘要成功几个、失败几个、总耗时多少、文件存到了哪里一目了然。失败的链接会自动写入项目根目录的failed_urls.txt复制回config.py即可重试完全不用手动记小本本。背后发生了什么3 个值得知道的原理Q1为什么要并行下载音视频再合并B 站的高清视频会把画面和声音拆成两条独立的数据流。工具的做法是同时拉取两条流下载完再合成一个文件。这样做的直接收益就是速度画质越高、体积越大并行带来的优势越明显。Q2断点续传和自动重试是怎么兜底的下载中断时工具会从已完成的位置接着传而不是推倒重来遇到网络波动还会自动重试最多 5 次。这意味着一份大文件的下载过程即使被打断你也不用守在电脑前从头再来。Q3分 P 链接怎么做到指哪下哪链接末尾带?pN时工具会精确解析出对应的分 P 编号只下载你指定的那一集不带参数则按合集整体处理。这套识别逻辑在strategy/目录的代码中有完整实现。进阶玩法把下单个视频升级成批量囤货用一行代码生成整个系列的所有分 P想一口气拿下某部 10 集课程不需要手动写 10 行链接用列表推导式一键生成base https://www.bilibili.com/video/BV1EEEE4444 URL [f{base}?p{i} for i in range(1, 11)] # 自动生成第1~10集把成品存到你想放的地方config.py里的OUTPUT_PATH就是输出目录改成移动硬盘或 NAS 的挂载路径即可临时文件会放在TEMP_PATH下载结束后程序会自动清理不会在磁盘上留下垃圾。通过并发数控制网速占用main.py中max_concurrent默认是 2。觉得下载太慢可以适当调大反过来如果担心占满带宽影响家人上网、追剧也可以调小灵活取舍。常见问题对照表踩坑前先看一眼现象原因对策只能下 360P 或提示权限不足Cookie 过期或失效按前面的步骤重新复制一次 Cookie 并替换明明填了链接却下成低清链接末尾少了/重定向丢失会员状态确保/video/BVxxxx后面先带/再接?p合并很慢甚至卡住机器上没有 ffmpegmoviepy 只能纯软件合成macOS 执行brew install ffmpegLinux 执行sudo apt-get install ffmpeg不装也能跑只是慢下载速度不理想并发数过高触发超时或撞上晚间高峰调小main.py里的max_concurrent尽量避开高峰时段番剧、电影下载失败该功能仍标注为待测试需要中国大陆 IP可等待后续版本更新最后工具是免费的但请带着分寸使用从克隆仓库到下载出第一个视频全程大约十几分钟一次配置可以长期复用。无论是备份付费课程、收藏创作者的高质量内容还是搭建自己的离线视频库这个工具都能把收藏真正变成硬盘里实实在在的文件。最后再叮嘱一句下载的内容请仅用于个人学习与离线备份尊重创作者版权遵守 B 站用户协议不要二次分发或用于商业用途。工具本身没有对错善用它优质内容生态才能长久运转下去。【免费下载链接】bilibili-downloaderB站视频下载支持下载大会员清晰度4K持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考