B站视频下载保姆级实测一个 Python 脚本把大会员 4K 和充电专属视频轻松存到本地【免费下载链接】bilibili-downloaderB站视频下载支持下载大会员清晰度4K持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloader上个月末我蹲点追的一档充电专属系列突然弹出版权提示评论区哀嚎一片说再不下载就没了。那一刻我彻底想明白了在线内容终究是平台借给你的想真正拥有唯一的办法是把它变成本地文件。这篇就把我用 bilibili-downloader 这个 Python 开源项目从装环境、配 Cookie 到把大会员 4K 视频拉回本地的全过程原原本本写给你包括我踩过的每一个坑。起因付费内容说没就没我不想再赌运气坦白讲我一开始没打算折腾下载工具。充了大会员站内看 4K 很方便手机 App 缓存虽然丑但也能凑合。真正让我坐不住的是那两件事我花电池充电解锁的系列视频作者明确说了随时可能因为版权问题下架下架那天我花的钱就打水漂了报了一门十几节的付费网课我想把每一节剪进自己的学习笔记里反复回看可客户端缓存的文件格式根本没法直接拿来用说白了我需要一个稳定的搬运通道把视频从 B 站的服务器搬到我的硬盘上。之前试过几个在线解析站不是要充会员就是隔三差五失效。最后干脆决定用开源工具自己动手一劳永逸。它到底是什么一句话就能说清楚bilibili-downloader 是一个用 Python 写的 B站视频下载工具核心能力一句话概括把 B 站任意投稿视频包括大会员 4K 清晰度、充电专属视频、分P视频下载到本地自动合并音视频全程异步并发还带断点续传。它最大的卖点不是能下载而是什么都能下——普通视频不用说大会员专属的 4K、8K 画质还有需要付费解锁的充电专属内容只要你有对应权限它都能帮你存下来。安装三步走每步都给你自查方法我的环境是 Windows Python 3.11项目要求 Python 3.8 以上基本是个机器就能跑。整个安装过程就三步第一步把仓库拉到本地git clone https://gitcode.com/gh_mirrors/bil/bilibili-downloader cd bilibili-downloader看到生成了一个bilibili-downloader文件夹里面有main.py、config.py这些文件就说明 clone 成功了。第二步安装依赖pip install -r requirements.txt依赖清单很干净就四个库httpx负责发网络请求、beautifulsoup4解析页面、moviepy合并音视频、tqdm画进度条。都是常见库正常情况下一两分钟装完不会卡壳。装完后可以用pip list看一眼确认这四个包都在列表里。第三步确认 ffmpeg 是否可用可选但推荐ffmpeg -version如果你机器上有 ffmpeg工具合并音视频时会优先走 ffmpeg速度飞快没有也没关系它会自动退回 moviepy 方案不影响使用只是合并稍慢一点。我当时机器上正好有 ffmpeg所以全程体验都很顺。第一步实操让工具认出你的大会员身份装好之后先别急着下载普通视频不配 Cookie 也能下但想拿到 4K、想下充电专属内容就必须让工具认识你。这一步的作用就是把你的账号登录态告诉工具。做法很简单打开 config.py 文件你会看到顶部有个COOKIE变量。我要做的就是把浏览器里登录后的 Cookie 整段复制进去用 Chrome 或 Edge 登录 B 站随便打开一个视频页按 F12 打开开发者工具切到网络Network标签按 F5 刷新页面点列表里第一个请求在请求头Request Headers里找到cookie字段右键复制整段值然后把这段超长的字符串原样粘到 config.py 的COOKIE ...里保存文件即可。这里有个我踩过的坑提前给你打预防针Cookie 里的SESSDATA大约 30 天过期。过期之后下载会拿不到高画质甚至会提示权限不足。到时候不用慌重新按上面三步复制一遍新的 Cookie 贴上就行别的什么都不用改。第二步实操把想下载的视频写进清单下载哪些视频同样在 config.py 里维护——一个URL列表搞定。我看了一下它的注释支持三种写法URL [ # 普通视频 https://www.bilibili.com/video/BV1xx123456/, # 分P视频指定下载第2集 https://www.bilibili.com/video/BV1xx654321/?p2, # 充电专属视频 https://www.bilibili.com/video/BV1xx789012/, ]多个链接一行一个想下多少放多少工具会按顺序批量处理。我当时正好报了一门课把十几节的链接全列了进去一次任务全部解决省得我一遍遍复制。顺带一提如果你想先验证工具能不能跑通建议第一单先放一个普通视频不依赖会员权限那种确认全流程没问题了再加 4K 和充电专属的链接。我第一次就是直接塞了个充电视频进去结果半天没反应排查半天才发现是 Cookie 的问题。python main.py然后就看屏幕刷屏配置全部就位后在项目根目录运行python main.py终端会先打印一段下载配置待下载视频数量、并发模式默认最多同时下载 2 个视频每个视频内部音视频又是分开并发下的、输出目录。然后进入逐条下载。我第一次跑的时候看到终端那个画面确实有点惊喜每个文件都有独立进度条速度、剩余大小实时跳动视频和音频两个进度条并排往前跑能明显感觉到比一条条串着下快不少。等两条都跑满它会自动合并音视频合并完自动清理临时文件最后给出一份摘要✅ 成功下载几个视频每个视频标了清晰度我那次是高清 1080P❌ 失败的视频会列出标题和原始 URL还会自动写进根目录的failed_urls.txt这个failed_urls.txt是真的贴心——下载失败不用对着屏幕抄地址直接打开文件复制回URL列表重试就行。三个我亲测踩过的坑你最好提前知道坑一URL 少个斜杠画质直接掉到 480P这个坑我栽得很冤。我在复制分P链接时从地址栏拿到的格式是BVxxxxx?p2这种——BV 号后面没有斜杠。结果下载出来一看明明开着大会员画质却只有 480P一度以为是自己 Cookie 写错了。后来翻了源码 strategy/bilibili_executor.py 才发现玄机这种不带斜杠的链接会被 B 站重定向重定向过程会丢掉登录状态画质自然就掉下来了。工具内置了一个_normalize_url方法会自动把BVxxxxx?p2规范成BVxxxxx/?p2保住 1080P 甚至更高清晰度。所以链接不用你手动改工具会替你处理——但如果你自己手动拼链接记得养成带斜杠的习惯。坑二下到一半断了居然能从断点继续一个 4K 视频动辄几个 G我第一次下的时候家里网络正好抽风进度条卡在 60% 断掉了。本来以为要重头再来结果重新跑一遍python main.py发现它先检查了本地已有文件的大小然后从断点接着下速度直接起飞。看了源码才知道它下载时会带上Range: bytes已下载大小-的请求头服务器就从断点续传如果文件已经完整下载过还会直接提示已经下载完毕跳过。对下载大文件来说这个细节真的太实用了省的不是一点半点时间。坑三番剧、电影下不动先检查你的网络环境我在URL列表里看到有番剧/电影的注释示例/bangumi/play/ss39429这种就顺手试了试结果一直报错。后来看到 config.py 里的注释才明白番剧和电影需要中国大陆 IP因为 B 站的正版内容有区域限制。挂代理反而会翻车把代理关掉、用本地网络直连就好了。这个坑不算工具的问题但第一次用的人很容易懵。想二次开发它的代码结构比想象中清爽如果之后想改点功能这项目的组织方式很值得夸一嘴。整体就四个部分main.py入口负责编排整个流程——读取配置、调度下载、合并、清理、输出摘要config.py所有配置集中在这里Cookie、URL、输出目录都在这一处改models/数据模型Video定义了视频对象和清晰度映射8K、杜比视界 4K、1080P 等Category定义了视频分类strategy/核心逻辑bilibili_executor.py里拆了三个类——BilibiliExecutor负责解析 URL 和识别类型、BilibiliDownloader负责并发下载、VideoMerge负责合并音视频我最喜欢的是它用的策略模式普通视频走default.py番剧走bangumi.py新增一种视频类型只需要加一个策略类不用去动主流程。想扩展新场景就是加代码而不是改代码对二次开发非常友好。最后说两句回到开头那个问题在线内容会消失但存在自己硬盘里的不会。用 bilibili-downloader 把大会员 4K 和充电专属视频存到本地这件事整套流程走下来我的感受是门槛低到了会复制粘贴就行——装依赖、贴 Cookie、粘链接、敲一行命令半小时内绝对能跑通。如果你也正在经历视频突然下架想离线看 4K素材剪不进笔记这些破事真心建议花半小时试试这个工具。自己动手存下来的每一份内容都是你个人知识库的一块砖攒着攒着就成了一面墙。【免费下载链接】bilibili-downloaderB站视频下载支持下载大会员清晰度4K持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考