B站视频下载免费教程：bilibili-downloader 三步拿下大会员4K与充电视频

郑悦莲

5280人浏览 · 2026-08-20 11:30:47

郑悦莲 · 2026-08-20 11:30:47 发布

B站视频下载免费教程：bilibili-downloader 三步拿下大会员4K与充电视频

【免费下载链接】bilibili-downloader B站视频下载，支持下载大会员清晰度4K，持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloader

想看的课程没有下载按钮，喜欢的UP主开了充电专属，付费了也只能在线看——面对"存不下来"的B站视频，你有几条路？bilibili-downloader 是一个开源免费的 B站视频下载工具，专攻大会员4K、充电专属视频、批量与分P下载，装好依赖、改一个配置文件就能跑。下面这份上手教程会带你从零把它装进自己的电脑。

你还在和在线解析站较劲吗

先算一笔账：你打算存10个B站视频，从搜解析站、跳过广告、点"开始解析"，到发现画质被压成480P、链接中途失效……这一套流程走下来要花多久？更别提大会员4K和充电专属内容，多数解析站根本无能为力。与其把链接交给第三方服务器换来一堆糟心事，不如自己动手——工具就在本地跑，数据不出你的电脑。

一次讲清它能干什么

先看一张对比表，你就明白它和在线解析站的区别：

对比项	在线解析站	bilibili-downloader
画质	常被压到480P	按账号权限取最高清晰度，最高4K
大会员内容	通常不支持	填入Cookie后直接获取
充电专属视频	几乎解析不了	支持离线收藏
批量下载	一个链接一个链接手动来	URL列表一次跑完
隐私	链接上传到第三方服务器	本地运行，不经过他人
费用	各种会员套路	开源免费

用清单卡片再浓缩一遍核心能力：

🎬 大会员4K下载——适合开了大会员、想存原画画质的人；
🔒 充电视频保存——适合付费支持了UP主、想留档收藏的人；
📚 多P智能识别——适合追合集、连载、分P教程的人；
⚡ 批量排队下载——适合想囤下整个课程系列的人；
🔁 断点续传与自动重试——适合网络不稳、怕下到一半失败的人；
📊 进度条与自动清理——适合想实时看到进度、又不想留下垃圾文件的人。

三步完成配置：从安装到跑通

整个过程只有三步：装环境、填Cookie、填链接。每步我都会补一句"为什么这么做"。

第1步：装好 Python 3.8+ 并拉取项目

工具用 Python 编写，先确认电脑里有 Python 3.8 或更高版本，然后打开终端执行：

git clone https://gitcode.com/gh_mirrors/bil/bilibili-downloader
cd bilibili-downloader
pip install -r requirements.txt

requirements.txt 里四个库各司其职：httpx 负责发网络请求，beautifulsoup4 负责解析页面结构，moviepy 负责把分离的音视频合成一个文件，tqdm 负责画出你看到的进度条。装好后，项目里会多出 main.py（程序入口）和 config.py（配置中心），后面要改的基本都在这一个文件里。

第2步：填好 Cookie，解锁最高清晰度

打开 config.py，把 COOKIE 那一行的值替换成你自己的。获取方法：

用浏览器登录 B 站，打开任意视频页；
按 F12 打开开发者工具，切到「网络（Network）」标签；
刷新页面，点击列表里的第一个请求，在请求头中找到 Cookie 字段；
把整串 Cookie 复制下来，贴进 config.py 的 COOKIE 变量。

原理一句话：Cookie 相当于你身份的电子门禁卡，程序带着它去请求，B站才会按你的账号权限返回对应的清晰度。需要提醒的是，Cookie 里的 SESSDATA 大约 30 天就会失效，届时重新复制一次替换即可。

第3步：贴入链接，运行程序

在 config.py 的 URL 列表中填入想下载的视频页链接，然后执行：

python main.py

原理：main.py 会逐个解析链接，识别视频类型后并发拉取音视频流，再用 ffmpeg（没有则自动退回 moviepy）合并成完整 mp4，保存到 output 目录，结束后还会打印一份下载摘要。想了解内部实现，可以翻一翻 strategy/bilibili_executor.py 和 models/video.py。

实战演示：把一节4K课程完整存下来

拿最典型的场景——"下载大会员4K课程"——完整走一遍：

打开 config.py，确认 COOKIE 已填好（这是取到4K的前提）；
在 URL 列表粘贴课程链接，例如 https://www.bilibili.com/video/BVxxxxxxxx/?p=1；
运行 python main.py；
终端依次显示：视频标题 → 清晰度（超清 4K）→ 音视频进度条 → 合并提示 → 清理临时文件 → 下载摘要；
到项目的 output 目录里，找到那条完整的 mp4 文件。

整个下载过程不需要你一直盯着，跑完看摘要即可；万一有视频失败，程序会把失败的链接自动写进 failed_urls.txt，方便你稍后重试。

让体验更顺手的进阶玩法

批量囤一个系列：把整个系列的链接按顺序排进 URL 列表，一次跑完，适合建立个人课程库；
只下某一P：在链接末尾加 ?p=2，就能只取合集里的第2集；
换存放位置：想存进外接硬盘或NAS，改 config.py 里的 OUTPUT_PATH；TEMP_PATH 是临时目录，程序跑完会自动清理；
充分利用断点续传：中途断网不用重头再来，工具用 Range 请求从断点继续，网络错误还会自动重试5次；
番剧电影尝鲜：往 URL 里塞番剧页链接也能试，但需要中国大陆IP，且该类型支持仍在完善中，别抱太高预期。

报错后如何自检：现象、原因与解决办法

现象：下载下来只有480P → 原因：链接重定向丢了会员状态，或Cookie过期 → 解决：确认链接是 /video/BV.../ 带斜杠的形式（工具会自动规范化处理），再重新复制一次Cookie；
现象：提示找不到视频数据 → 原因：视频已下架，或需要登录/会员权限 → 解决：换成可正常访问的链接，并确认Cookie仍然有效；
现象：下载到一半失败 → 原因：网络波动 → 解决：工具会自动重试，多次仍失败就把 failed_urls.txt 里的链接重新排进 URL 列表重跑；
现象：合并阶段报错 → 原因：系统没装 ffmpeg → 解决：安装 ffmpeg 后工具会优先用它合成（更快），否则会退回 moviepy；
现象：视频打不开 → 原因：播放器不兼容 → 解决：换用 VLC、PotPlayer 这类通用播放器，或删掉重下一次排除文件损坏。