1. 为什么我最终选择了 bilibili-downloader1.1 从一次真实的下载需求说起去年帮一个做影视剪辑的朋友整理素材他需要把B站上几段4K画质的城市延时摄影下载下来做混剪。我一开始想的是用浏览器插件装了三四个要么只能抓到720P要么下载下来音视频分离还得手动合并折腾了一下午没搞定。后来在GitHub上翻到了bilibili-downloader这个开源项目命令行跑了一条命令4K视频带着音频直接落盘那一刻的感觉就是——之前的时间全白费了。这篇文章就是把我这段时间用 bilibili-downloader 的完整经验整理出来。它本质上是一个基于Python的命令行工具专门用来下载B站视频支持4K、1080P 60帧、HDR等高清规格能自动合并音视频流还能批量下载合集和番剧。适合谁看如果你经常需要把B站视频存到本地做素材、做笔记、做离线观看又不想被各种限制卡住那这篇内容就是写给你的。哪怕你之前没碰过命令行跟着步骤走也能跑通。1.2 它到底解决了什么核心问题B站网页端本身不提供直接的视频下载按钮这是很多人都知道的事。但背后的原因值得说清楚B站的视频播放采用的是DASH流媒体协议视频画面和音频是分开传输的两条流网页播放器实时把两路流合在一起播放。这就意味着就算你用一些嗅探工具抓到了地址拿到的往往也只是画面流或者音频流其中之一单独下载下来要么没声音要么没画面。bilibili-downloader 的核心价值就在于它把这一整套流程自动化了登录鉴权、获取视频流地址、分别下载视频流和音频流、调用FFmpeg合并成完整的MP4文件。你只需要给它一个视频链接剩下的它全包了。而且它支持登录态登录之后能下载1080P以上的高码率版本包括4K。这一点很关键因为B站很多高清规格只对登录用户开放。1.3 和其他方案对比它的优势在哪市面上下载B站视频的方案大致有这么几类我做个对比你就明白了方案类型代表工具最高画质音视频合并批量下载登录支持浏览器插件各类视频下载扩展通常720P部分支持弱依赖浏览器Cookie在线解析网站各类在线解析站1080P支持不支持不稳定通用下载器某些全能下载工具依赖嗅探需手动支持复杂bilibili-downloader本项目4K/HDR自动强完善浏览器插件的问题在于它工作在网页环境里能拿到的流地址有限而且B站经常调整接口插件失效是常态。在线解析站更不用说了广告满天飞画质压缩严重还有隐私风险。通用下载器配置起来门槛高对B站的DASH协议支持也不够好。bilibili-downloader 是专门针对B站做的接口适配及时画质能拉到最高这是我选它的根本原因。2. 上手前的环境准备与核心原理2.1 你需要准备什么在开始之前先把这几样东西备齐Python 3.8 或更高版本这是运行环境Windows、macOS、Linux都行。Windows用户去Python官网下载安装包安装时记得勾选“Add Python to PATH”不然命令行里找不到python命令。FFmpeg这是音视频合并的关键工具bilibili-downloader 依赖它来把分离的画面流和音频流合成MP4。Windows用户下载FFmpeg的压缩包解压后把bin目录加到系统环境变量Path里macOS用户用Homebrew装最省事一条brew install ffmpeg搞定Linux用户用包管理器装就行。一个B站账号想下载1080P以上画质必须登录这个后面会详细说怎么配置。稳定的网络4K视频文件体积不小一集二十分钟的4K视频可能有好几个GB下载前确认下磁盘空间。提示FFmpeg的安装是新手最容易卡住的地方。装完之后在命令行输入ffmpeg -version如果能看到版本信息输出说明配置成功了。如果提示“不是内部或外部命令”那就是环境变量没配好回去检查Path。2.2 安装 bilibili-downloader 的两种方式安装方式我推荐用pip这是最省心的pip install bilibili-downloader如果你用的是macOS或者Linux可能要用pip3代替pip。装完之后输入bilibili-downloader --help能看到帮助信息就说明装好了。另一种方式是从GitHub克隆源码安装适合想跟进最新功能或者自己改代码的人git clone https://github.com/项目地址.git cd bilibili-downloader pip install -r requirements.txt源码安装的好处是版本最新有些新功能pip上的版本可能还没更新。但缺点是要自己处理依赖偶尔会遇到依赖冲突。新手建议先用pip方式跑通了再考虑源码。2.3 登录鉴权的原理和配置方法这一步是能不能下载高清视频的分水岭。B站的策略是未登录用户只能拿到360P或480P的低清流登录之后才能解锁1080P、4K等规格。所以配置登录态是必须的。bilibili-downloader 支持两种登录方式。第一种是扫码登录运行命令后它会生成一个二维码你用B站手机App扫一下就行这种方式最安全不用手动处理Cookie。第二种是手动传入Cookie适合在服务器或者没有图形界面的环境里用。扫码登录的操作是这样的bilibili-downloader login --qrcode运行后终端会显示一个二维码手机B站App扫码确认登录信息会保存到本地配置文件里后续下载就不用重复登录了。手动Cookie方式稍微麻烦点需要你在浏览器里登录B站按F12打开开发者工具在Application或Storage里找到Cookie把SESSDATA这个值复制出来然后bilibili-downloader login --cookie 你的SESSDATA值注意SESSDATA相当于你的登录凭证不要分享给别人也不要在公共电脑上保存。如果泄露了别人可以冒充你的账号操作。2.4 DASH协议下音视频分离的底层逻辑这里稍微展开讲一下原理理解了之后你遇到问题就知道该往哪个方向排查。B站的DASH流里一个视频通常包含这几条流视频流可能有多个清晰度、音频流通常一条、有时候还有字幕流。每条流有独立的URL下载的时候是分开下的。bilibili-downloader 的工作流程是先请求视频信息接口拿到所有可用流的列表然后根据你指定的清晰度筛选出对应的视频流和音频流分别下载这两个文件到临时目录最后调用FFmpeg执行合并命令把视频流和音频流封装成一个MP4文件。合并这一步用的FFmpeg命令大致是这样的ffmpeg -i video.m4s -i audio.m4s -c copy output.mp4-c copy的意思是直接复制编码流不做重新编码所以合并速度非常快几秒钟就能完成而且画质无损。这也是为什么必须装FFmpeg的原因——没有它你拿到的就是两个分离的文件播放器打不开。3. 核心功能实操从单视频到批量下载3.1 下载单个4K视频的完整命令最基本的用法就是给它一个视频链接bilibili-downloader download https://www.bilibili.com/video/BVxxxxxxxxx默认情况下它会下载最高可用画质。如果你想明确指定4K可以加上清晰度参数bilibili-downloader download https://www.bilibili.com/video/BVxxxxxxxxx --quality 4k清晰度的可选值一般有360p、480p、720p、1080p、1080p60、4k这几档。注意能不能下到4K取决于两个条件一是你的账号有权限登录状态二是这个视频本身提供了4K源。有些老视频最高只有1080P你指定4K也没用工具会自动降到可用的最高画质。下载过程中终端会显示进度条包括已下载大小、速度、剩余时间。4K视频下载比较吃带宽如果速度慢可以试试换个时间段或者检查下是不是被限速了。3.2 批量下载合集和番剧的技巧B站很多内容是合集形式比如系列教程、番剧、纪录片。一个个复制链接太累了bilibili-downloader 支持直接传合集或番剧的链接bilibili-downloader download https://www.bilibili.com/video/BVxxxxxxxxx --playlist加上--playlist参数后它会自动识别这个链接下的所有分P或剧集然后依次下载。我实测下载一个30集的番剧挂在那里跑一晚上就全下完了。批量下载有几个实用参数值得记住--start 5从第5集开始下载前面几集如果已经有了就跳过。--end 20下载到第20集为止。--threads 4同时下载的线程数默认是1调大能加快速度但别调太大容易被限流。实操心得批量下载番剧的时候建议把--threads设在2到4之间。我有次设了8结果下载到一半触发了B站的频率限制后面几个文件全部失败。稳妥起见细水长流比一时快更重要。3.3 字幕和弹幕的下载方法很多人不知道bilibili-downloader 还能把字幕和弹幕一起下下来。字幕对于做笔记、翻译、学习类内容特别有用。下载字幕bilibili-downloader download 链接 --subtitle字幕会以ass或srt格式保存具体格式取决于视频本身提供的字幕类型。如果视频有多个语言的字幕它会全部下载。下载弹幕bilibili-downloader download 链接 --danmaku弹幕会保存成XML格式这个格式可以用一些弹幕播放器加载或者用工具转成ass字幕在本地播放器里看。如果你想把弹幕压制进视频里那就需要额外的转码步骤了这个后面在进阶部分会说。3.4 输出文件的组织与命名规则默认情况下下载的文件会保存在当前目录下命名规则是“标题-分P名.mp4”。如果标题里有特殊字符工具会自动替换掉避免文件名出错。你可以用--output参数指定输出目录bilibili-downloader download 链接 --output ./我的视频也可以用--template自定义命名模板比如按UP主名字分类bilibili-downloader download 链接 --template {uploader}/{title}.mp4支持的模板变量一般有{title}、{uploader}、{bvid}、{page}等。合理设置模板能让你的文件库井井有条后期找素材的时候省很多事。4. 常见问题排查与避坑指南4.1 下载下来没有声音怎么办这是新手遇到最多的问题十有八九是FFmpeg没装好或者没配到环境变量里。bilibili-downloader 下载完视频流和音频流之后需要调用FFmpeg合并。如果FFmpeg不可用它可能只保留了视频流或者两个文件都下了但没有合并。排查步骤很简单先在命令行输入ffmpeg -version确认FFmpeg能正常运行。如果这一步就报错那就是安装或环境变量的问题重新装一遍。如果FFmpeg没问题那就检查下载目录里是不是有.m4s结尾的临时文件有的话说明合并步骤失败了可以手动执行合并命令ffmpeg -i video.m4s -i audio.m4s -c copy output.mp44.2 4K选项不可用是什么原因指定了4K但下载下来还是1080P通常是这几个原因没登录未登录状态下B站只给低清流登录之后才能拿到高清。检查一下登录状态是否有效Cookie可能过期了。视频本身没有4K源不是所有视频都上传了4K版本工具会自动降到可用的最高画质。账号权限不足部分高画质内容需要大会员才能解锁普通账号只能拿到1080P。提示可以在下载命令后面加上--list-formats参数它会列出这个视频所有可用的清晰度你就能看到到底有没有4K源以及你的账号能拿到哪一档。4.3 下载速度慢的优化思路下载速度受几个因素影响你的带宽、B站服务器的响应、同时下载的线程数。如果速度不理想可以试试这几个方法用--threads增加并发数但别超过4否则容易触发限流。避开网络高峰时段晚上八九点通常比较慢凌晨会快很多。检查是不是走了代理有些网络环境下代理会拖慢速度。如果单个视频很大可以考虑只下载需要的分P用--start和--end控制范围。4.4 常见问题速查表问题现象可能原因解决方法下载后无声音FFmpeg未安装或未配置安装FFmpeg并加入环境变量只有360P/480P未登录或登录过期重新扫码登录4K选项灰色视频无4K源或权限不足用--list-formats确认可用画质下载中途失败网络波动或触发限流减少线程数重试文件名乱码系统编码问题设置--template用英文命名合并后画面花屏流文件损坏删除临时文件重新下载4.5 几个我踩过的坑第一个坑是Cookie过期。B站的SESSDATA有效期大概一个月左右过期之后下载会自动降到低画质但工具不会报错你以为下的是4K其实拿到的是480P。所以定期检查登录状态很重要我现在的习惯是每周跑一次bilibili-downloader login --check确认状态。第二个坑是磁盘空间。4K视频体积大得惊人我有次批量下载一个纪录片合集没注意磁盘剩余空间下到一半磁盘满了前面下的文件也损坏了。现在我会先估算一下总大小留出至少两倍的空间再开始。第三个坑是文件名冲突。同一个UP主的不同视频如果标题相似下载后可能覆盖。用--template加上{bvid}变量就能避免因为每个视频的BV号是唯一的。5. 进阶玩法与效率提升5.1 配合脚本实现自动化下载如果你有定期下载某个UP主新视频的需求可以写个简单的脚本来自动化。思路是先用B站的API获取UP主的最新视频列表然后逐个传给 bilibili-downloader 下载。import subprocess import requests # 获取UP主视频列表的示例思路 uid 你的目标UP主UID api fhttps://api.bilibili.com/x/space/arc/search?mid{uid}ps10 response requests.get(api) data response.json() for video in data[data][list][vlist]: bvid video[bvid] subprocess.run([bilibili-downloader, download, fhttps://www.bilibili.com/video/{bvid}])这个脚本只是演示思路实际用的时候要处理登录鉴权、分页、去重等问题。但核心逻辑就是这样跑通之后你就不用每天手动检查更新了。5.2 下载后的视频处理建议下载下来的4K视频如果直接存着时间长了容易占满硬盘。我的做法是素材类的视频保留原始4K版本观看类的视频转成1080P存档能省不少空间。转码用FFmpeg就行ffmpeg -i input_4k.mp4 -vf scale1920:1080 -c:v libx264 -crf 23 -c:a aac output_1080p.mp4-crf 23是画质参数数值越小画质越好但文件越大23是个比较均衡的值。转码比较吃CPU一个小时的4K视频可能要跑一两个小时建议晚上挂着跑。5.3 关于画质修复和超分的说明热词里有人提到“1080P视频修复到4K”这属于另一个技术领域了叫视频超分辨率。简单说就是用AI模型把低分辨率视频放大到高分辨率同时尽量保持清晰度。常用的工具有Real-ESRGAN、Topaz Video AI等。但我要泼个冷水超分不是万能的。它能把画面变“锐”但无法凭空创造出原本不存在的细节。一个1080P的视频超分到4K观感上会比直接拉伸好很多但和原生4K比还是有差距。如果你追求的是原生4K画质那还是得下载本身就提供4K源的视频。5.4 工具选型的个人建议用了这么久我的建议是bilibili-downloader 适合需要高画质、批量下载、自动化处理的场景。如果你只是偶尔下载一两个视频看看浏览器插件可能更方便。但如果你像我一样需要把B站当素材库用那这个工具值得花时间配置好。另外提醒一句下载的视频请仅用于个人学习、研究等合理用途尊重创作者的劳动成果。B站上很多优质内容都是UP主花了很多心血做的支持他们的最好方式还是在平台上正常观看、点赞、投币。最后分享一个我常用的小技巧下载之前先用--list-formats看一眼可用画质确认有4K源再开始下避免下完了才发现画质不对白费功夫。这个习惯帮我省了不少重复下载的时间。