B站视频下载终极指南免费开源工具一键保存4K大会员与充电专属视频【免费下载链接】bilibili-downloaderB站视频下载支持下载大会员清晰度4K持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloader你是不是也有这样的经历收藏夹里躺着一堆值得反复回看的教程出差路上信号一差就只能对着转圈的画面干瞪眼你充电支持了喜欢的UP主对方放出的专属视频却只能在网页端播放想离线保存却无从下手。bilibili-downloader就是为这类看得见、存不下的困境而生的——它是一款免费开源的 Python 命令行工具专注 B 站视频下载支持大会员 4K 清晰度与充电专属视频适合想建立本地视频资源库的普通用户、学习党与内容创作者。读完这篇文章你将完整跑通一次 B 站视频下载流程。为什么你需要一个看得见也存得下的下载工具在线播放永远受制于三个变量网络、会员状态、平台规则。网课想看第二遍只能反复拖动进度条通勤路上想补番信号稍差就卡成幻灯片更别提那些随时可能因版权而下架的充电专属视频错过一次可能就再也找不到。把视频存到本地等于一次性买断随时可看的自由。bilibili-downloader 的出现就是想把这件事变得像复制粘贴一样简单你只管准备好账号信息和视频链接剩下的解析、下载、合并全交给工具自动完成。整个项目只有几个 Python 文件结构清爽没有任何花哨的界面专注做好下载这一件事。先弄懂原理B站的高清视频是怎么锁住的动手之前花两分钟理解机制能省下后面不少排查时间。B站的高清内容并不是谁都能下的公共资源服务端会根据请求里携带的账号身份决定放行到哪一档清晰度。直接复制网页里的视频地址去下载等于以一个匿名游客的身份访问拿到的往往只有模糊的 480P大会员专属的 4K 更是直接提示无权限。bilibili-downloader 的思路很直接把 B 站账号的 Cookie 作为身份证明注入到每一次请求里。服务端校验通过后会返回当前账号最高可达的清晰度列表。项目的 models/video.py 里内置了完整的清晰度档位映射从流畅 360P一路排到超高清 8K其中就包含大会员专属的超清 4K120、杜比视界 4K126。工具在解析时会自动从流列表里选取第一路也就是质量最高的那一路——Cookie 配对了4K 就只差一条命令的距离。第一步实战三分钟配置账号Cookie这是整个流程里唯一需要手动操作、也最容易出错的环节其实全程不到三分钟。在浏览器里找到你的会员卡用 Chrome 或 Edge 登录 B 站打开任意一个视频页面按F12打开开发者工具切到网络Network标签按CtrlR刷新页面点击请求列表中的第一条在右侧请求标头里找到Cookie字段整行复制。下面这张仓库官方截图演示的正是这个操作跟着红框标注的位置走即可粘贴进配置文件打开项目根目录下的 config.py找到COOKIE ...这一行把你复制的整串 Cookie 粘到引号内替换掉旧值保存即可。注意不要把引号删掉也不要粘贴成两行。这里有两个必须牢记的提醒Cookie 有保质期其中的SESSDATA大约 30 天失效届时要重新走一遍上面的流程替换这也是 config.py 注释里特意标注定期更换的原因Cookie 就是你的账号钥匙拿到它等于拿到账号的部分操作权限建议只在本机使用切勿随意分享给他人。第二步实战把想下载的视频链接填进列表打开 config.py你会看到一个URL列表里面用引号包着一条条视频链接。想下载什么就把链接按行填进去格式如下URL [ # 普通视频 https://www.bilibili.com/video/BV1M4411c7P4, # 分P视频只取第2集 https://www.bilibili.com/video/BV1TnsZzHEcz?p2, # 充电专属视频 https://www.bilibili.com/video/BV12gYxz7ESf, ]三个值得记住的细节分P用?p参数想下第几集就写?p几不写则默认第 1 集链接可以混着填普通视频、分P、充电专属视频可以出现在同一个列表里程序会自动识别链接类型调用不同的下载策略你完全不用操心分类一次列清所有分P比如某充电合集有 6 集就把p1到p6六条链接都填进去一次跑完中途不用再动手。第三步实战一条命令启动批量下载配置完成进入项目根目录执行两条命令pip install -r requirements.txt python main.py第一行安装全部依赖第二行启动下载程序。运行后主程序 main.py 会先打印一份下载配置清单——待下载数量、并发模式、输出目录一目了然让你在动手前就对整个任务心里有数。随后你会看到tqdm进度条实时滚动视频与音频并行下载完成后自动合并。下面这张动图展示了终端里的完整运行过程全部跑完后程序还会输出一份摘要成功几个、失败几个、总耗时多少甚至把失败的链接自动导出到项目根目录的failed_urls.txt里供你下次直接复制重试。下载完成的视频统一落在项目的output目录临时文件会被自动清理目录始终干净整洁。一次配置之后每次只需要往URL列表里加链接就能持续收获本地视频库。藏在代码里的三个可靠设计小工具能稳定跑下来靠的是 strategy/bilibili_executor.py 里几个不起眼却关键的工程细节。断点续传与自动重试下载超过 1GB 的大文件时断网几乎是必然事件。工具做了两层保险一是利用 HTTP 的Range请求头实现断点续传——文件已存在多少字节就接着从那个位置继续下绝不推倒重来二是单次失败后自动重试最多 5 次每次间隔 5 秒临时性的网络抖动基本能自己扛过去。音视频并发下载与无损合并B 站高清视频的流媒体是音画分离的视频流 音频流分开传输这也是很多一把梭下载器下完没声音的根源。这个项目会把视频流与音频流同时并发下载再用ffmpeg无损合并如果机器上没有 ffmpeg会自动降级为内置的 moviepy 合并方案成片就是正常的有声 MP4。URL规范化守住高画质如果你把BV号?p2这种不带斜杠的链接直接填进去B 站会返回一次重定向而重定向可能丢失会员状态、把清晰度打回 480P。项目内置了 URL 规范化逻辑自动把链接补全为带斜杠的形式BV号/?p2保住本该属于你的高清晰度。这是个容易被忽略、却能直接决定画质的关键细节。常见问题速查表跑通之后如果遇到异常对照下面这张表基本都能定位症状原因解法一直报无权限或只出 480PCookie 过期或填错重新按第一步流程获取替换 config.py 中的COOKIE视频下载成功却打不开合并环节缺 ffmpeg安装 ffmpeg 后重跑合并更快更稳番剧下载失败并提示地区限制内容仅限中国大陆 IP确认使用中国大陆网络环境后再试下载到一半卡住不动网络波动不用管内置重试会自动续上下载进阶玩法番剧、电影与你的个人视频库普通视频之外bilibili-downloader 还预留了番剧与电影的支持。项目采用策略模式在 strategy/ 目录下同时维护了普通视频策略default.py与番剧策略bangumi.py程序会根据 URL 自动判断走哪条路径。像https://www.bilibili.com/bangumi/play/ss39429这样的链接可以直接填入URL列表。唯一的硬性条件是番剧电影需要中国大陆 IP——如果你在海外这类内容会因地区限制而下载失败代码里也做了明确的地区限制检测与友好提示。跑通一次之后你还可以试试这些延伸方向用?p参数批量抓取某个 UP 主整个充电系列的全部集数攒成一套完整课程把output目录接入网盘或 NAS搭建跨设备的个人视频库翻阅 strategy/ 下的源码理解策略模式如何工作未来自己动手扩展新的下载类型。现在整个闭环已经在你手里了拿到 Cookie → 填进 config.py → 把链接写进URL列表 → 跑python main.py→ 去output目录收货。大会员 4K、充电专属、分P 合集、批量任务这些场景你都能独立搞定。打开配置文件把第一条你想永久保存的视频链接填进去吧——工具的价值只有在你真正跑通一次之后才会显现。【免费下载链接】bilibili-downloaderB站视频下载支持下载大会员清晰度4K持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考