BilibiliDown 新手完全指南：轻松搞定 B站视频下载与批量离线保存-平芜编程栈

BilibiliDown 新手完全指南：轻松搞定 B站视频下载与批量离线保存

【免费下载链接】BilibiliDown(GUI-多平台支持) B站哔哩哔哩视频下载器。支持稍后再看、收藏夹、UP主视频批量下载|Bilibili Video Downloader 😳项目地址: https://gitcode.com/gh_mirrors/bi/BilibiliDown

凌晨一点，你刷到一节特别想存下来的网课，B站没有下载按钮；浏览器里的"解析下载"插件三天两头失效；好不容易找到在线转换站，出来的画质糊成一团，还塞满广告。这种被卡住的感觉，几乎每个B站重度用户都经历过。BilibiliDown 就是为"把 B站视频存进自己硬盘"这一件事而生的开源免费工具，能直接解析视频流、保留原始画质，还支持收藏夹和 UP主全集的批量下载。这篇文章，我跟着一位新手朋友"小A"从安装、首次下载到进阶配置完整走了一遍，把值得抄的作业都整理给你，保证你今晚就能跑通第一次下载。

它到底能干什么：一个"私人内容仓库管家" 📦

一句话定位：BilibiliDown 是一款跨平台的 B站视频下载器，Windows、macOS、Linux 都能跑，开源协议为 Apache 2.0，项目仓库在 GitCode 上持续更新。

你尽可以把它想象成一位"私人内容仓库管家"：你递过去一条链接——AV/BV 号、番剧分集、合集、收藏夹、UP主主页都行——它负责解析、排队、去重、归档，最后把文件整整齐齐放回你指定的书架。

主界面比想象中朴素：一个输入框、一个"查找"按钮、上方几个功能 Tab。没有广告横幅，没有会员引导弹窗，剩下的全是干活的地方，第一次打开也不会手足无措。

小A 的安装流水账：三分钟把快捷方式放到桌面 🖥️

小A 是那种"能复制粘贴绝不打命令"的普通用户，她的整个安装过程只做了三件事：

确认电脑里有 Java 8 或更高版本（项目唯一的环境要求，没有就去官网装一个）；
克隆仓库，到release目录拿现成脚本——Windows 双击Create-Shortcut-on-Desktop-for-Win.vbs，macOS 双击Double-Click-to-Run-for-Mac.command，Linux 在终端执行Create-Shortcut-on-Desktop-for-Linux.sh；
桌面出现快捷方式，双击启动。

如果是从零开始，也可以在命令行里先拉下项目：

git clone https://gitcode.com/gh_mirrors/bi/BilibiliDown

启动后你会看到一个蓝白配色的窗口，就是上面那张图的样子。小A 的第一反应是"就这？"——但她很快发现，简单界面后面藏着的功能一点都不简单。

小A 的首次下载实录：从复制链接到文件落盘 ⚡

小A 的第一次下载只花了 30 秒。她从手机 App 复制了一条 BV 链接，粘贴进输入框，点"查找"。你会看到程序开始解析，随后弹出一个标签页，里面是该视频的标题、分P列表和可选清晰度。

选清晰度时，数值对应明确的画质档位：320P=16、480P=32、720P=64、1080P=80、1080P+=112，再往上还有 4K（120）和 8K（127）。B站给什么源，这里就显示什么——非会员通常拿不到 1080P+ 以上的档位，这是平台规则，不是工具的锅。

点"下载"后进度条开始走。好奇的小A 顺手打开任务管理器看了看，发现整个程序是一个 Java 进程，内存占用在 400MB 上下，下载时的 CPU 占用不到 4%，几乎不打扰她同时开着的浏览器和文档。

如果下载的是收藏夹、稍后再看或会员专享内容，记得先点右上角的"点击登录"，用 B站 App 扫一下二维码即可。

登录凭据会保存在config/cookies.config文件里，下次启动不用重复扫码；想退出登录，直接删掉这个文件或在菜单里操作就行。

批量下载与文件归档：让 UP主全集自动"各回各家" 📚

真正让下载效率产生质变的是批量能力。小A 试着把她关注的一位UP主的全部作品一次拿下：复制主页链接 → 粘贴 → 查找，程序会分页列出该UP主的所有视频（默认每页 5 条，可在bilibili.pageSize调大）。下载策略选"全部"，优先清晰度填 80，点"执行"，剩下的就是等。

同样的思路可以套用到收藏夹（favlist 链接）、合集（ml开头）、番剧（ep/ss）。收藏夹链接末尾还能追加p=2、p=3这样的参数来加载更多页条目，批量操作非常顺手。

批量下载的第一次，小A 发现文件名全是avTitle-p001-80这种，找起来费劲。解决办法在config/app.config里的命名格式bilibili.name.format。常用变量有：avTitle（标题）、pDisplay（合集序号）、UpName（UP主名）、UpId（UP主ID）、qn（清晰度）、cTime（发布时间）、listName（收藏夹名）。它还支持条件式语法，比如(:listName listName/)表示"存在收藏夹名时，自动加一个前缀目录"。小A 最终用了这样一组格式：

bilibili.name.format = UpName/(:listName listName/)avTitle-(:cTime cTime-)pAv2-qn(avId)

实际效果是：下载完成后，文件自动按UP主名/收藏夹名/标题-日期-p01-80(av号).mp4归档。小A 的原话是："我整理文件夹都没它整齐。"

另外两个高频配置顺手提一句：保存路径用bilibili.savePath = download/，相对绝对路径都支持；同时下载任务数用bilibili.download.poolSize = 3，官方建议 3~5，不是越大越快，调太高反而容易触发风控。

三个值得一玩的进阶用法 🎯

1. 收藏夹全量备份，命名自动带收藏时间。用途：把个人收藏夹完整导下来，作为离线资料库。做法：登录后粘贴收藏夹链接，命名格式里加上(:listName listName/)与收藏时间变量favTime（格式可用bilibili.name.date.favTime.pattern = yyMMdd控制），然后全量下载。效果：备份会按收藏夹自动建目录，每个视频文件名带上收藏日期，以后翻资料一眼定位。

2. 多线程分块下载，明显提速不伤系统。用途：大文件下载速度不满意的提速方案。做法：在配置里把bilibili.download.multiThread.count设为 4，再配合bilibili.download.multiThread.minFileSize设置阈值（小于该 MB 数的文件不启用分块）。效果：大视频被拆成多块并行下载，整体速度明显提升，而 CPU 依然保持低占用。

3. 仓库模式去重，批量任务自动跳过已下载。用途：定期同步 UP主新视频或"稍后再看"列表时避免重复劳动。做法：确认bilibili.repo = on，下载成功的记录会持续写入config/repo.config；之后每次下载前程序先查仓库，已存在的直接跳过。效果：全量重跑一遍也不会重复下载，配合"稍后再看"列表，等于给自己搭了一个轻量级的订阅更新器。

新手最容易踩的坑，和对应的解药 🧭

下载到一半关掉程序，留下.part结尾的临时文件→ 不用重下，重新打开同一个任务会从断点继续；想尽量拿到 MP4，把bilibili.format设为 0。
明明选了 1080P，拿回来的却是 480P→ B站对非会员限制清晰度；部分老番剧只有 FLASH 源，只能下到 FLV，换登录会员号通常能解。
提示"该视频已下载"但到处找不到文件→ 是config/repo.config里的历史记录在"认领"，删掉对应那一行，或临时把bilibili.repo设为 off 再试。
批量下载时弹出一堆"已下载"确认框→ 在配置里把bilibili.alert.isAlertIfDownloded设为 false，世界立刻清净。
解析之后一直转圈或一片空白→ 多半是视频已被删除或违规；换个链接确认，若全都不行，检查是否开了失效的代理。
下载好的视频没声音或无法播放→ 音视频分离的 MP4 需要 ffmpeg 参与合并，确认bilibili.ffmpegPath指向的 ffmpeg 可用；兜底方案是装一个 VLC 播放器。

下载完成后，程序会直接给出文件路径，右侧的"打开文件""打开文件夹"按钮一步到位——这个细节小A 很喜欢，因为她再也不用在一堆乱码文件夹里大海捞针。

写在最后：把它变成你的长期视频库 🌙

BilibiliDown 的价值不在于"能下载"这种一次性满足，而在于把下载变成了一件可以长期托管的事：批量、去重、自动命名、断点续传，组合起来就是一个会自己维护的私人视频库。想深入研究的同学，解析逻辑在src/nicelee/bilibili/parsers/，下载器在src/nicelee/bilibili/downloaders/，界面层在src/nicelee/ui/；仓库里的release/wiki/Q&A.md有作者整理的问答，绝大多数"怪问题"都能在里面找到现成答案。

最后照例提醒一句：下载的内容请仅用于个人学习与收藏，尊重每一位UP主和版权方的劳动，不要拿去做二次传播。愿你的硬盘里，存下的都是真正值得反复回看的作品。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考