B站视频下载指南：用bilibili-downloader免费获取4K画质与充电专属视频-育师

B站视频下载指南：用bilibili-downloader免费获取4K画质与充电专属视频

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

如果你刷B站时遇到过这些烦恼——喜欢的教程视频想离线反复看、大会员专属的4K画质想存到本地、给UP主充电后那些独家内容想永久收藏——那么今天要介绍的bilibili-downloader就是为你准备的。它是一个完全免费开源的Python工具，只需简单配置，就能批量下载B站视频，支持4K高清、分P处理和充电专属内容，真正实现"离线观看自由"。

动手之前：先备齐这三样东西

照做之前，先确认三件事，缺一不可：

Python 3.8 或更高版本—— 在终端输入python --version即可确认
一个登录了B站的浏览器—— 后面取 Cookie 要用
一份项目代码—— 克隆到本地并安装依赖：

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

依赖安装这一步会把网络请求、页面解析、音视频合并所需的库一次性装好。装完之后，项目里的config.py就是你唯一需要动脑子的文件。

小提示：如果电脑上同时装了多个 Python 版本，把命令换成pip3和python3即可。

第一次下载：三步照做就能跑通

第一步：把 Cookie 填进 config.py

想要下载大会员专属的 4K 画质，必须让工具"认识"你的账号。方法很简单，30 秒搞定：

用浏览器登录 B 站，打开任意视频页面
按F12（或右键选择"检查"）打开开发者工具，切到"网络"标签
刷新页面，点击请求列表中的第一个请求
在右侧请求头里找到cookie字段，复制整段内容
粘贴到config.py里的COOKIE = '...'中，替换掉原来的值

⚠️ 注意：Cookie 里的关键字段SESSDATA大约 30 天就会失效，到时候重新复制粘贴一次即可。建议在手机里设个每月提醒。

第二步：把想下载的视频链接写进列表

打开config.py，找到URL列表，把想要的视频链接填进去。几种常见写法一次说清：

URL = [ # 普通视频，直接贴链接 'https://www.bilibili.com/video/BV1xx123456', # 分P视频，?p=2 表示只下载第2集 'https://www.bilibili.com/video/BV1xx654321?p=2', # 充电专属视频，填入链接即可 'https://www.bilibili.com/video/BV1xx789012', ]

链接想加多少加多少，工具会自动处理，你不用操心先后顺序。

第三步：运行并等待

在项目目录下执行：

python main.py

程序会先打印下载配置，接着显示每个视频的标题和清晰度，然后分视频、音频两条进度条并行下载，最后自动合并音视频、清理临时文件，并输出一份下载摘要——成功几个、失败几个、用时多久、存在哪个目录，一目了然。

下载完成的视频默认保存在项目的output目录里，直接就能用播放器打开。

进阶玩法：把这些隐藏能力用起来

跑通基本流程之后，下面这些功能能让你的下载体验再上一个台阶。

批量下载：一次把整个系列搬回家

教程合集、UP 主系列视频，把链接全部丢进URL列表即可。工具默认同时下载 2 个视频，每个视频内部的音频和视频又是并行下载的，速度快又不会把服务器压垮。想调整并发数，改main.py里的max_concurrent参数就行。

分P视频：只想下某一集？加个参数

B 站的多集视频（分P）只要在链接后面加?p=集数就能精确定位。比如?p=2只下第 2 集，?p=5只下第 5 集。想全集下载，就把每一集的链接都填进去。

充电专属视频：充了钱的内容也能存

工具支持下载需要充电才能观看的独家视频，前提是你登录的账号本身就有观看权限，Cookie 配置正确即可。虚拟主播的特别直播回放、知识区 UP 主的深度内容，都可以永久珍藏。

输出目录：存到你想存的地方

默认视频存在项目下的output目录，临时文件在temp目录。想改位置的话，编辑config.py里的这两行：

TEMP_PATH = os.path.join(BASE_PATH, "temp") OUTPUT_PATH = os.path.join(BASE_PATH, "output")

改成外接硬盘、NAS 的绝对路径都行，方便备份和管理。

失败自动留档：断点重试不发愁

如果某个视频因网络波动下载失败，程序会把失败视频的 URL 自动写入failed_urls.txt。下次把里面的链接复制回config.py重跑一遍即可，不用重新手动找链接。

避坑指南：新手最容易遇到的五个问题

Cookie 过期导致"权限不足"

这是出现频率最高的问题。下载失败先检查 Cookie 是否过期——SESSDATA只有约 30 天有效期，重新获取并更新到config.py即可。

会员画质下不下来

确认你的账号具备对应权限：4K 需要大会员，充电视频需要已充电。Cookie 对应的账号权限不够，工具也无能为力。

番剧和电影还在测试阶段

目前对番剧、纪录片的支持还在开发中，而且需要中国大陆 IP 才能访问，可能要多试几次或调整网络环境。想尝鲜的话，config.py里已有示例链接可参考。

下载的视频打不开

先装个万能播放器，如 VLC 或 PotPlayer，绝大多数格式都能播。如果仍然不行，多半是下载过程中出了问题，重新下载一次通常能解决。

磁盘空间告急

一部 4K 视频动辄几个 GB，下载前先确认磁盘剩余空间充足。高清内容建议按需选择画质，别一股脑全下 4K。

想深入研究？源码结构一分钟看懂

项目虽然小巧，代码结构却很清晰，按职责分了几个目录：

models/：数据模型层，video.py定义视频对象和清晰度映射，category.py负责视频分类
strategy/：策略执行层，bilibili_executor.py是核心执行器，另有bangumi.py（番剧策略）和default.py（默认策略）
config.py：你的配置文件，Cookie 和视频链接都在这里
main.py：程序入口，负责调度下载、合并、清理和摘要输出

整体采用异步并发设计，用信号量控制并发数，逻辑清晰，对想学习 Python 异步编程的同学来说也是一份不错的参考。