B站视频下载工具完整教程：免费把大会员4K与充电视频保存到本地

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

朋友阿凯上周发来求助："下个月要出差两周，想在路上复习那套分了六P的算法课，可它要大会员才有高清，B站又不让离线下载，愁死了。"别急——B站视频下载工具（bilibili-downloader）这款开源的 Python 脚本，就是专门把 B 站视频保存到本地的：支持大会员 4K、分P、批量与充电专属视频下载。收藏夹里那些"以后再看"，从此真能离线看。

一句话看懂它是什么

B站视频下载工具是一个开源的本地下载脚本，用你的账号身份（Cookie）换取最高 4K 的下载权限，把视频完整保存到电脑里，供你随时离线观看。

它适合三类人：

• 学生党：想把教程、网课存进电脑慢慢学；
• 老粉：想把喜欢的 UP 主作品永久收藏；
• 大会员用户：付费了 4K 权限，却总在没网的地方打开视频。

为什么它能做到快、稳、省心？核心在于三点：Cookie 认证解锁会员清晰度；异步并发同时拉取音频和视频；下载完成后自动合并、自动清理临时文件，全程几乎不需要人工干预。

三分钟快速上手：从安装到第一次运行

前提很简单：电脑装了 Python 3.8 或更高版本，然后执行：

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

白话解释一下依赖：httpx 负责网络请求，beautifulsoup4 解析视频页面，moviepy 把音视频合二为一，tqdm 显示进度条。装完再做两件事：打开 config.py 填好 Cookie（下节细说），在 URL 列表里粘贴你想下载的视频链接。然后：

python main.py

几秒钟后你就能看到下图这样的效果——标题、清晰度、音频和视频各自的进度条依次滚动，结束后还会输出一份下载摘要，告诉你成功几个、用时多久、存在哪里。

配置Cookie：解锁大会员清晰度的钥匙

Cookie 相当于你的账号通行证。B 站默认只给匿名访客低清晰度，而工具会带着你的 Cookie 去请求，服务器识别出会员身份后，才会下发 4K 等高清晰度地址。获取方法：

1. 用 Chrome 或 Edge 登录 B 站，打开任意视频页；
2. 按 F12 打开开发者工具，切到"网络"标签，按 Ctrl+R 刷新页面；
3. 点击第一个请求，在请求头 Cookie 字段里找到 SESSDATA 等一长串值，整体复制；
4. 粘贴到 config.py 的 COOKIE 变量中，保存即可。

这里要提醒一句：SESSDATA 大约 30 天就会失效，失效后下载会报错，重新复制一遍就行。建议在手机日历里设个每月提醒。

核心功能实战：四个高频使用场景

场景一：把大会员 4K 视频变成本地文件

阿凯的算法课是大会员专属高清。把链接填进 URL 列表后，工具会自动识别可用的最高清晰度（支持 8K、4K、1080P60、1080P+、1080P 等多档），运行时终端会明确显示"清晰度：超清 4K"这类信息，你能清楚看到自己到底拿到了什么画质。

场景二：下载充电专属视频

有些 UP 主的独家内容需要"充电"才能看。这类链接同样直接粘贴进 URL 列表即可——只要你的账号有权限，工具就能把它保存下来。对真心想收藏内容的观众来说，这比每次在线加载、反复拖动进度条省心得多。

场景三：只下载分P视频里的某一集

遇到"从零开始学 XX"这种几十集的长视频，不必全部下载。在链接末尾加个参数即可精确定位：

URL = [ 'https://www.bilibili.com/video/BV1xxxxxxx/?p=2', # 只下第2P ]

工具会解析出 p 参数，下载后用"_P2"这样的后缀命名文件，多集之间不会互相覆盖，文件名一目了然。

场景四：一次批量下载多个视频

URL 列表支持同时填写多个链接，工具默认最多同时下载 2 个视频（每个视频内部音视频并发），既提升了效率，又不会对服务器造成太大压力。跑完一次，output 目录里就是一份整齐的 MP4 合集。

让下载更稳更快的几个实战技巧

• 优先安装 ffmpeg：合并音视频时，如果系统里有 ffmpeg，工具会直接调用它做无损快速合并；没有才退回 moviepy。装一个能明显提速。
• 断点续传自动生效：下载中途断网不用慌，工具通过 Range 请求续传，已下载的部分不会浪费；单次下载失败还会自动重试最多 5 次。
• 失败链接自动留档：跑完一批后，失败的链接会写进项目根目录的 failed_urls.txt，复制回 URL 列表就能重试，不用手动记。
• 自定义保存位置：config.py 顶部的 OUTPUT_PATH 就是成品目录，可以改成外接硬盘、NAS 或网盘同步目录，方便多设备共享。
• 链接规范化小细节：工具会自动把 BV 号后面的链接整理成带斜杠的格式，避免重定向导致清晰度悄悄掉到 480P，这个小设计很贴心。

新手最常问的五个问题

Q1：下载报错、进度条不动是怎么回事？大概率是 Cookie 过期了。先更新 Cookie 再试；若仍失败，检查一下当前网络环境是否正常。

Q2：为什么我的清晰度选项里没有 4K？4K 等高档清晰度依赖大会员身份，请确认账号已开通会员，并且 Cookie 里的登录状态是最新的。

Q3：番剧、电影能下载吗？项目内置了番剧处理策略，但官方标注为"待测试"；同时部分番剧和电影需要中国大陆 IP 才能访问，这部分暂不保证可用。

Q4：下载完的视频打不开怎么办？建议使用 VLC、PotPlayer 这类全能播放器。如果确认是文件损坏，删掉后重新下载一次即可。

Q5：会占很多硬盘空间吗？4K 视频一小时可达数 GB。下载前留意磁盘余量，也可以只挑需要的分P 下载来控制体积。

写在最后：合理使用，也欢迎一起共建

工具能帮你把喜欢的视频留在本地，但请务必记住：它只应服务于个人学习、研究和备份收藏，请尊重 UP 主的创作与平台规则，不要用于传播或商用。

如果你在使用的过程中遇到问题，或者有新的功能想法（比如代理支持、字幕下载），欢迎到项目仓库提交 Issue 或参与代码贡献——这是一个持续更新的开源项目，你的每一条反馈，都可能让下一个版本的它更好用。

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