B站视频下载完整指南开源工具bilibili-downloader从4K到充电视频全攻略【免费下载链接】bilibili-downloaderB站视频下载支持下载大会员清晰度4K持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloaderbilibili-downloader 是一款专注于B站视频下载的开源工具它的核心卖点非常直接借助你自己的账号 Cookie就能下载到大会员专属的 4K 高清画质充电才能看的独家视频同样支持更贴心的是批量下载、多 P 分集下载、断点重试这些懒人刚需它全都内置好了。如果你还在为好视频只能在线看、下了班就没网而烦恼这篇教程会带你用一顿饭的功夫把它变成你电脑里的常驻工具。下面我们不按说明书的方式罗列功能而是模拟一次完整的把视频搬回家旅程——从动念、打包行李到通关、满载而归沿途的坑和捷径我都会指给你看。一个念头那些让你想把B站搬回家的时刻先对号入座一下你有没有遇到过这些场景刷到一套很棒的编程教程想在地铁上离线复习结果网络一卡一卡进度条比蜗牛还慢关注了很久的 UP 主发了充电专属视频你在要不要充的边缘反复横跳想收藏一部经典番剧的 1080P/4K 版本却发现网页端不登录会员只能看 720P一个系列有十几 P你想一口气全部存下来慢慢看。这些痛点的共同答案就是一个能解析 B 站真实画质流地址、并完成下载与合成的工具。bilibili-downloader 恰好把这几件事打包好了支持大会员清晰度最高可达 4K 甚至 8K、支持充电专属视频、支持批量与分 P 下载全程带进度条和下载摘要下载完还会自动合并音视频、清理临时文件属于开箱即用的类型。 一句话理解它的工作方式它做的事情和你在网页上看视频没有本质区别只是把你看到的音视频数据流下载到本地再合成为一个完整的 MP4 文件。出发前的行囊B站视频下载工具安装步骤既然是出门远行先把装备备齐。环境要求不高一台装了Python 3.8 及以上版本的电脑即可Windows、macOS、Linux 都行。打开终端依次执行下面三条命令git clone https://gitcode.com/gh_mirrors/bil/bilibili-downloader cd bilibili-downloader pip install -r requirements.txt依赖一共四个都不算陌生httpx负责异步网络请求、beautifulsoup4负责解析页面信息、moviepy负责音视频合成、tqdm负责画出好看的进度条。整个安装过程通常一两分钟就能完成。这里有两个小坑提前帮你踩掉如果pip下载依赖很慢可以临时换用国内镜像源例如pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple如果你的电脑上同时装了 Python 2 和 Python 3记得用pip3和python3来区分别敲错了。装完依赖你还可以顺手检查一下系统里有没有ffmpeg终端执行ffmpeg -version。有它音视频合并会走更快的流复制通道没有也不慌工具会自动回退到 moviepy 完成合并只是稍慢一点。第一道关卡给工具配一张会员通行证工具装好了但直接运行它下载会员视频会被告知权限不足。原因很简单B 站要靠 Cookie 来识别你是谁、开了什么会员工具本身并不知道你的账号身份。所以出发前你需要从浏览器里借一张通行证——也就是你登录 B 站后浏览器自动保存的那串 Cookie。整个过程只需要做一次Cookie 失效后重复一遍即可按下面的步骤来用 Chrome 或 Edge 登录你的 B 站账号随便打开一个视频页面按F12打开开发者工具切到网络Network标签页按Ctrl RMac 上是Cmd R刷新页面在左侧请求列表里点击第一个请求在右侧请求头Request Headers区域找到cookie字段复制整个 cookie 值打开项目里的config.py把COOKIE ...引号里的内容整体替换掉。如果你找不到具体位置可以对照下面这张截图红色箭头标注的就是操作入口替换完之后保存文件这张通行证就办好了。⚠️ 两个必须知道的事一是 Cookie 里的SESSDATA大约30 天会失效建议在手机日历上设个每月提醒失效后重新获取即可二是 Cookie 等同于你的登录凭证千万不要发到公开场合或提交到代码仓库否则别人就能用你的账号了。填好下载清单普通视频、分P与充电专属的配置姿势拿到通行证下一步是告诉工具你想搬哪些东西回家。所有待下载的链接都写在config.py的URL列表里一行一个链接用注释区分类型# 下载视频的 URL 列表 URL [ # 普通视频 https://www.bilibili.com/video/BV1xx123456, # 分P视频指定下载第 2 集 https://www.bilibili.com/video/BV1xx654321?p2, # 充电专属视频 https://www.bilibili.com/video/BV1xx789012, ]这里有几个实用的填单技巧普通视频直接把视频页的完整链接贴进来即可多带的无用参数不影响下载分 P 视频链接末尾加?p2就只下第 2 集不加p参数则默认下载第 1 集。想一次下完整个系列就多复制几行、把p依次改成 1、2、3……充电专属视频只要你的账号已经充电、且 Cookie 有效直接贴链接就能下载工具会自动完成授权验证番剧与电影config.py里预留了bangumi/play/格式的链接写法但官方标注待测试且需要中国大陆 IP 才能访问属于体验阶段不建议作为主力用途。 小贴士链接可以随意调换顺序工具会按列表顺序逐个处理用注释把课程系列 A / 灵感素材 B / 番剧待办分组标注以后维护起来一目了然。按下启动键从进度条到视频躺进硬盘清单填好出发。在项目目录下运行python main.py工具会先打印一段配置信息待下载数量、并发模式、输出目录然后进入正式的下载流程。你会在终端看到类似这样的画面第一次跑的时候你可能会有几个疑问提前给你翻译一下终端里的信息清晰度那一行工具会读取当前 Cookie 能拿到的最高画质比如高清 1080P、超清 4K。models/video.py里维护了一张清晰度对照表从流畅 360P到超清 4K、杜比视界 4K甚至超高清 8K都在支持范围内双进度条B 站高画质视频采用音视频分离的 DASH 格式所以你会看到音频和视频两条进度条并行推进互不拖累这就是它下载快的秘诀之一自动合并音视频都下完后工具会自动调用 ffmpeg 把两者合成为一个带声音画面的 MP4然后自动清理临时文件不给你留一堆垃圾下载摘要全部任务结束后终端会汇总成功几个、失败几个、用时多久失败的视频还会把链接单独导出到failed_urls.txt方便你下次重试。所有成品视频默认保存在项目根目录下的output/文件夹里按视频标题命名分 P 视频会带_P1、_P2这样的后缀一眼就能认出来。下载背后的小聪明与进阶玩法如果说前面是会用这一节是用好。这个工具在细节上藏了不少省心设计理解了它们你就能在遇到状况时对症下药并发与限流。默认最多同时下载 2 个视频每个视频内部音视频又各自并发既快又不会因为请求太猛被 B 站限制。想调整并发数改main.py里的max_concurrent即可。断点续传与自动重试。每个分片请求都带Range头下载中断后重新运行会从已下载的字节数接着下而不是从头再来单次失败还会自动重试最多 5 次间隔 5 秒。所以大文件下载遇到网络抖动别急着删重跑一次往往就续上了。URL 自动规范化防掉画质。这是一个很隐蔽的坑/video/BVxxxx?p2这种不带斜杠的链接会被 B 站重定向重定向后会员状态可能丢失导致只返回 480P。工具会在解析前自动把链接规范成/video/BVxxxx/?p2的格式从源头保住高画质。自定义保存位置。如果你想把视频直接存进外接硬盘或 NAS修改config.py里的OUTPUT_PATH即可# 视频输出目录改成你喜欢的位置 OUTPUT_PATH /path/to/your/movies批量管理的长期习惯。建议你维护一个自己的下载清单文本文件攒一批链接后一次性粘进config.py批量执行下载失败的链接会出现在failed_urls.txt里排查完原因后复制回去重试即可。另外 B 站接口偶尔会调整工具也会持续更新隔段时间拉一下最新代码更安心git pull pip install -r requirements.txt --upgrade翻车现场急救手册B站下载常见报错解决用久了难免遇到状况这里把最高频的几个问题连同解决步骤一起给你问题一提示权限不足或视频全部下载失败。原因几乎都是 Cookie 过期了。B 站的SESSDATA大约 30 天失效按第一道关卡的步骤重新获取并替换config.py里的COOKIE即可。建议每月固定日期做一次养成习惯就不会被中断。问题二下载速度很慢。先确认是不是网络高峰期B 站服务器和本地带宽都会影响速度其次检查是否有其他程序占满带宽。工具本身已做了并发优化一般 4K 大文件需要一些耐心。如果你同时下了很多视频也可以把max_concurrent调低一点避免互相抢带宽导致整体更慢。问题三下载完成后视频无法播放。先确认播放器是否支持常见格式——推荐 VLC 或 PotPlayer系统自带播放器偶尔会闹脾气。如果换播放器还不行很可能是下载过程中文件损坏删除对应文件重新下载一次即可。工具自带断点续传重试成本很低。问题四明明开了大会员却只下到 480P/720P。先检查 URL 里?p后面是否带了多余参数导致重定向工具虽然会自动规范化但最稳妥的做法是只保留干净的链接其次确认 Cookie 里包含有效的SESSDATA且未过期最后B 站部分极高清画质如杜比还要求会员等级和特定设备标识工具会按当前 Cookie 能拿到的最高档位自动选择。问题五番剧、电影下载不了。这是工具明确标注的待测试功能。番剧类链接需要中国大陆 IP 才能解析海外网络环境下基本会失败。建议先专注使用普通视频、分 P 和充电视频这三块成熟能力番剧等后续版本支持更完善再尝试。写在最后工具好用也要用得体把 B 站视频下载到本地最实在的价值是把想看的变成随时能看的通勤路上离线刷教程、信号差的地方照样看收藏、好内容永久备份不失效。但请一定记住这个工具的正确打开方式是个人学习与收藏——下载的内容请勿二次传播或商用尊重每一位 UP 主的创作劳动也是保护这类工具能持续存在下去的前提。现在去config.py里填上你的 Cookie 和第一个视频链接跑一次python main.py看看进度条跑起来的样子吧。如果遇到文中没覆盖到的问题翻一翻项目的 README或者把报错信息连同使用场景记录下来到项目页提个反馈——开源工具就是这样用的人越多它就会变得越好用。【免费下载链接】bilibili-downloaderB站视频下载支持下载大会员清晰度4K持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考