B站视频下载工具 bilibili-downloader 完全指南：3 步把 4K 高清视频存到本地

B站视频下载工具 bilibili-downloader 完全指南3 步把 4K 高清视频存到本地【免费下载链接】bilibili-downloaderB站视频下载支持下载大会员清晰度4K持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloader想在通勤路上、出差途中也能继续看 B 站视频开源下载工具bilibili-downloader帮你把普通视频、大会员 4K 清晰度、充电专属内容批量存进本地硬盘——不依赖浏览器插件也不靠时好时坏的在线解析站。配置一次登录凭证之后贴链接就能跑。先看效果一条命令跑完的全过程先描述一下你运行python main.py后会看到什么心里有个预期终端先打印下载配置待下载数量、并发模式、输出目录每个视频显示标题和将下载的清晰度随后视频流、音频流两条进度条并行跑实时显示速度与百分比下载完成后自动合并成 MP4并清理临时文件最后输出一张摘要清单成功几个、失败几个、总用时、视频保存位置整个过程无需任何人工干预一条视频从开始到落盘全程自动。三步走完全流程从拿到代码到视频落盘第一步装好环境1 分钟搞定工具只依赖 Python 3.8克隆仓库后装依赖即可git clone https://gitcode.com/gh_mirrors/bil/bilibili-downloader cd bilibili-downloader pip install -r requirements.txtrequirements.txt 里只有 4 个库httpx异步请求、beautifulsoup4页面解析、moviepy音视频合并、tqdm进度条没有沉重的负担。第二步配置 Cookie一次有效约 30 天免费视频不配 Cookie 也能下但大会员 4K 和充电专属内容必须让工具认出你是谁。操作只需四步用 Chrome 或 Edge 登录 B 站打开任意一个视频页按F12或右键检查切到**网络**标签按Ctrl R刷新页面点击列表里第一个请求在请求头里找到Cookie字段整段复制把复制的值贴进config.py的COOKIE ...一行。注意 Cookie 里的SESSDATA大约 30 天过期届时重走一遍上面流程即可。第三步贴链接运行在config.py的URL列表里加入目标链接支持一次性贴多条URL [ https://www.bilibili.com/video/BV1xx123456, # 普通视频 https://www.bilibili.com/video/BV1xx654321/?p2, # 分P视频只下第2P ]保存后运行python main.py工具会按列表顺序批量处理。失败的链接会被自动写入项目根目录的failed_urls.txt复制回列表重试即可。它是怎么拿到 4K 的机制拆解这套工具稳的关键在于它直接以你的登录身份请求 B 站接口权限跟着你的账号走而不是绕过什么限制。几个值得了解的点自动识别链接类型/video/BV...走普通视频策略/bangumi/play/...走番剧策略分发表在 strategy/bilibili_executor.py分别由 strategy/default.py 和 strategy/bangumi.py 实现画质自动取最高档B 站对高清视频采用音画分离的 dash 格式工具会取接口允许的最高视频流 最高音频流并发下载清晰度从 360P 到 8K 的完整映射定义在 models/video.py低清小陷阱已处理形如BV1xx?p2的链接会触发重定向导致会员状态丢失、只返回 480P工具会自动规范化为BV1xx/?p2规避音视频合并优先调用系统的ffmpeg直接拷贝流合并快且不损失画质没装 ffmpeg 时回退到 moviepy 重新编码可靠性内置每个文件流最多自动重试 5 次中断后重跑会按已下载字节断点续传不会从零开始能力边界这些能下那些不行和浏览器插件、在线解析站放在一起看差距一目了然能力bilibili-downloader浏览器插件 / 在线解析站大会员 4K / 8K 源✅ 取接口允许的最高档⚠️ 多数封顶 480P充电专属视频✅ 支持❌ 基本无解多链接批量排队✅ 一次贴完即可⚠️ 逐条手动操作分P合集✅ 自动按标题_P2.mp4命名⚠️ 常只给到第一P进度与速度可视化✅ 双进度条实时刷新❌ 黑箱断点续传 失败自动重试✅ 内置❌ 失败即重来临时文件自动清理✅ 合并后即删❌ 缓存越积越多明确的限制也有⚠️番剧/电影模块仍在测试阶段且需要中国大陆 IP遇到报错需自行跟进 strategy/bangumi.py⚠️ 单集番剧链接暂不支持只处理了整季入口视频本身没开放 4K 源时工具也只能拿到接口给出的最高档进阶设置四个值得改的地方并发数默认同时下载 2 个视频在 main.py 里改max_concurrent即可调大输出位置config.py中修改OUTPUT_PATH可以把成品指到外接硬盘或 NAS断点续传无需配置重跑即可从断点继续分P命名多P视频自动输出为标题_P1.mp4、标题_P2.mp4一个系列整整齐齐下载失败四个高频问题的排查办法问题一下出来只有 480P而不是 4K先确认复制 Cookie 前你已经以大会员账号登录再确认这条视频本身开放了 4K 源——接口不给最高档时工具无法变出它。问题二视频没声音这是音视频未成功合并的信号。安装ffmpeg并加入系统 PATH 后重试工具会优先走 ffmpeg 快速合成播放建议用 VLC 或 PotPlayer。问题三提示权限不足、页面数据取不到大概率是 Cookie 过期了。重新获取 SESSDATA 更新到config.py建议每月检查一次别等失效了才发现。问题四一批链接里总有几条失败看运行末尾输出的失败清单或直接打开项目根目录的failed_urls.txt把链接复制回URL列表重跑临时网络抖动一般重跑一次就能过。把舍不得删的视频变成真正属于你的文件bilibili-downloader 把B 站视频下载这件事压缩成了固定动作贴 Cookie、填链接、跑python main.py不需要理解接口细节也不需要维护什么插件。今晚就能把收藏夹里那些怕下架、怕删稿、怕没信号的视频稳稳存进自己的硬盘。最后一句提醒下载内容请仅用于个人学习与备份尊重 UP 主和创作者的劳动不要用于商业传播。使用中遇到问题或有想法欢迎到项目页面提 Issue一起把这个工具磨得更好用。【免费下载链接】bilibili-downloaderB站视频下载支持下载大会员清晰度4K持续更新中项目地址: https://gitcode.com/gh_mirrors/bil/bilibili-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考