BilibiliDown 保姆级下载教程：3 个真实场景带你从零搬空 B 站视频库

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

你是不是也有这样的时刻：刷到一个超喜欢的课程视频，想存下来离线反复看，结果网页端找了半天没有下载按钮；关注的 UP 主更新了几百个视频，想全部收藏却只能一个个右键另存为；会员限定的高清画质明明开了大会员，下载工具却只能拿到低清版本。BilibiliDown 就是为这些场景而生的——一款基于 Java 的跨平台 B 站视频下载工具，支持 Windows、macOS、Linux 三大系统，既能下载单个视频，也能批量搞定收藏夹、稍后再看和 UP 主主页。读完这篇教程，你将学会：3 分钟内完成第一次下载、一键囤下整页视频、登录解锁会员画质，以及把下载体验打磨到顺手的小技巧。

场景一：周末想缓存一门网课，5 分钟拿下第一个视频

先从最朴素的需求讲起：把一个视频下载到本地。整个过程只有"找链接 → 点查找 → 选画质 → 点下载"四步。

第一步：先让软件跑起来

获取方式二选一：

• 从项目发布页下载对应系统的压缩包，解压即可使用；
• 用命令行克隆源码仓库：git clone https://gitcode.com/gh_mirrors/bi/BilibiliDown

软件基于 Java 开发，需要 Java 8 或更高版本运行环境；Windows 平台有附带精简 JRE 的安装包，没有 Java 环境也能直接用。

按你的系统启动：

预期结果：窗口弹出先显示一段过渡动画，随后进入主界面——顶部有"主页"和"下载页"两个标签页，主页中央是一个输入框和"查找"按钮，整体就是下图这样：

第二步：粘贴链接并点"查找"

操作：复制 B 站视频链接（AV 号或 BV 号都可以），粘贴到主页输入框，按下"查找"按钮或直接敲回车。

大白话解释：这里的"解析"就是把链接交给程序，程序去 B 站接口问出视频的真实信息——标题、UP 主、分 P 列表、支持哪些清晰度。这一步不需要你懂任何技术，填链接就行。

预期结果：稍等一两秒，界面切换成视频详情页，左边是标题、简介、封面，右侧列出可选的清晰度档位：

第三步：选清晰度，再选格式

在详情页右侧的清晰度列表中，挑一个你需要的档位：

• 高画质党：选 4K、1080P60、1080P+，前提是视频本身支持且你的账号有权限；
• 省空间党：选 720P 或 480P，文件体积小很多；
• 封面下方还有格式选项：默认 MP4（音视频分离后自动合并，兼容性最好），也可以切换为 FLV。

💡 文件大小是实时估算出来的，选不同清晰度时留意一下数字，心里有个底。

预期结果：点下载后任务进入下载页，你能实时看到文件名、下载速度、已下载大小和进度。下载完成时会提示音提醒，并显示"打开文件""打开文件夹""删除"三个操作按钮，点"打开文件夹"可以直接定位到成品文件：

顺手学会的第二个技能：同时下载多个

别急着关。主页输入框可以反复粘贴新链接点查找，每解析一个就新增一个 Tab。等打开了好几个 Tab 后，切到"下载页"标签——这里就是你的下载控制中心，所有任务都在这里排队执行。

操作：在下载页顶部选择"下载策略"，如果只想下每个视频的第一 P，就选"仅第一"；想整批全下，选"全部"。再选定优先清晰度，点击"执行"。

预期结果：任务按队列依次开始下载，同一个面板里能看到每个任务独立的速度和进度，互不干扰。这其实就是批量下载的雏形，下一个场景我们会把它玩到极致。

场景二：追更 UP 主与收藏夹备份，一键搬走整页视频

单个下载学会后，最爽的功能来了：BilibiliDown 能识别一大类 B 站链接，不只是单个视频，还包括 UP 主主页、收藏夹、稍后再看、频道合集，甚至 b23.tv 短链接和图文动态。

支持哪些"入口链接"

把下面任意一种链接粘进主页输入框，点"查找"，解析出的结果都会以 Tab 形式列出该集合下的全部视频：

📌易错点提醒：收藏夹链接务必带上fid参数，否则程序无法定位到具体收藏夹。如果收藏夹视频很多，可以在链接末尾加p=2、p=3这样的页码参数，分批加载后续内容。

批量下载的正确姿势

以 UP 主主页为例，完整走一遍：

1. 复制 UP 主空间链接，粘贴到输入框，点"查找"；
2. 程序解析出该 UP 主的视频列表，默认每页 5 条，一个 Tab 一条（在配置文件里把bilibili.pageSize调大，可以一页展示更多）；
3. 切到"下载页"，设置下载策略为"全部"（或者"仅第一"），并选择优先清晰度；
4. 点击"执行"按钮，批量任务开始排队。

预期结果：所有 Tab 里的视频按优先级依次进入下载队列，你在下载页能看到完整任务列表。中间某个视频失败了也不怕——程序默认自动重试，还能断点续传，中途手滑关掉程序，重开后下载进度依然保留。

⚠️ 批量下载时弹窗可能很吵。如果不希望"已下载"提示一个接一个往外冒，可以把bilibili.alert.isAlertIfDownloded改为false，或者调小bilibili.alert.maxAlertPrompt。

收藏夹一键备份

收藏夹是很多人内容沉淀的大本营。BilibiliDown 支持直接把收藏夹链接整批拉下来，配合仓库模式（后文会讲），每次执行都会自动跳过已下载过的视频，只补新收藏的内容——相当于给收藏夹做了个增量备份。

场景三：会员画质下载失败？先让工具"认识"你的账号

你可能已经遇到这个现象：明明开了大会员，网页能看 1080P 甚至 4K，下载时却只有 480P。原因很简单——工具没登录，B 站只给了游客权限。登录后这些问题基本都迎刃而解。

扫码登录，最快的方式

操作：在主界面找到登录入口，选择扫码登录（这是默认方式），界面会弹出一个二维码窗口：

预期结果：用手机 B 站 App 扫一扫并确认后，二维码窗口关闭，右上角显示你的头像和昵称，登录成功。除了扫码，还支持短信验证码和用户名密码登录，密码建议放在config/user.config文件里，程序读取后会自动删除该文件。

登录后解锁的能力

• 下载会员专享内容和高清画质（1080P+、4K 等，取决于你的会员等级）；
• 访问自己的收藏夹、稍后再看列表，并批量下载；
• 下载收藏的图文动态、相簿图片；
• 登录凭证明文保存在config文件夹下的cookies.config，如果想退出登录，在"操作 → 登录相关 → 退出登录"里操作即可，也可以直接删除该文件。

🔑 遇到风控（常见提示是 412 或 352 错误）时，先别急着重试。试试菜单栏里的"刷新 Cookie"功能，程序会在本地刷新登录态，通常能解除限制。你也可以把bilibili.login.cookie.tryRefreshOnStartup设为true，让程序每次启动时自动尝试刷新。

让下载体验更顺手的 5 个隐藏开关

这几个功能散落在菜单和配置文件里，但学会了它们，你才真正算"会用"这个工具。

1. 断点续传与失败重试

下载中断时，临时.part文件会保留在下载目录。重新开始下载时，程序会从上次的位置继续，而不是从头再来。配合bilibili.download.maxFailRetry = 3，单个任务失败后最多自动重试 3 次。

2. 仓库模式，杜绝重复下载

bilibili.repo = on开启仓库功能：每次下载前先查"已下载记录"，如果这个视频已经下过，直接跳过，不产生重复任务。记录保存在config/repo.config，不想要某条记录了，手动删掉那一行即可。

3. 自定义文件名规则

默认命名格式是bilibili.name.format = (:listName 0_listName\)UpName\avTitle-(:favTime favTime-)pAv2-qn，翻译成人话就是"按 UP 主建文件夹，标题 + 分 P + 清晰度命名"。你可以在配置里自由组合这些占位符：

avTitle # 视频标题 clipTitle # 视频小标题（分 P 标题） UpName # UP 主名字 qn # 清晰度值，如 80 favTime # 收藏时间 cTime # 发布时间

示例：想改成"UP主/标题-清晰度"的结构，可以这样写：

bilibili.name.format = UpName\avTitle-qn

改完保存，重新加载配置即可生效，不需要重启程序。预期结果：下一个视频下载完成后，文件名和文件夹结构立刻按新规则生成。

4. 只下音频，或连弹幕字幕一起收

在配置里把bilibili.dash.download.mode设为2，就只下载音频轨道，适合想存 BGM 的场景。另外，视频详情页还提供弹幕下载和CC 字幕下载，字幕默认保存为 srt 格式，弹幕可以转成 ass 字幕文件嵌入播放器——追番党收藏弹幕文化必备。

5. 一键下载配置，把常看的集合"自动化"

如果你有固定的追更列表（比如某几个 UP 主的主页、收藏夹），可以把这些链接写进config文件夹下一个名为batchDownload.config的文件。之后在菜单"配置 → 一键下载配置"里选它，点一下就能按计划批量下载。

预期结果：结合bilibili.download.batch.plan配置，程序甚至可以在启动时按设定时间段自动开始批量下载，下完还能通过邮件推送通知结果（bilibili.download.push.type设为Mail并配置账号即可）。

新手最容易踩的 5 个坑

问题导向最有价值。以下是社区里被问得最多的场景，直接对号入座。

坑 1：下载速度慢，还能救吗？

先看下载页的实际速度数值，再依次排查：

1. 确认是不是同时下载任务太多——默认同时最多 3 个任务（bilibili.download.poolSize = 3），任务越多单个越慢；
2. 网络高峰期避开热门时段；
3. 如果走代理，检查config/app.config里的socksProxyHost/socksProxyPort配置是否正确。

坑 2：设置了 MP4，下载出来却是 FLV？

bilibili.format = 0是"优先"下载 MP4 而不是"强制"。如果视频源站只有 FLV 格式，程序会自动切换为 FLV，这是正常现象，不是 bug。想要的一定是 MP4，就只能下载后用工具自行转码了。

坑 3：明明没下过，却提示"已下载"？

这是仓库模式在起作用。仓库记录可能来自之前用另一种清晰度下载过（默认bilibili.repo.definitionStrictMode = off，不同清晰度算同一条记录）。解决办法：在config/repo.config里删掉对应记录，或者把bilibili.definitionStrictMode改为on让不同清晰度分开记录。

坑 4：下载目录里的临时文件越堆越多？

临时文件（.part后缀）是断点续传的基础，正常下载完成后会自动清理。如果出现异常残留，把bilibili.restrictTempMode保持on，它会更严格地管理临时文件；确认无用的残留手动删除即可。

坑 5：视频解析出来一直"转圈圈"？

先排除偶发现象（再解析一次）。如果单个视频持续无响应，很可能是该视频已删除或违规。批量场景下建议先打开一个普通视频验证网络是否正常，再逐个排查异常链接。

配置文件速查表

所有配置都在config/app.config，这里放一张高频参数速查表，按需改动：

📌 配置修改后，大部分项在菜单里点"重新加载配置"即可生效，个别项（如主题）需要重启程序。界面里也有图形化设置面板，修改文件、文件夹类配置时可以直接用文件选择器，不用手敲路径。

写在最后：从"下载"到"管理"的距离

回顾一下，这篇教程其实讲了三层能力：入门层——用四步完成单个视频下载；进阶层——用 UP 主主页、收藏夹、稍后再看等入口实现整批搬运；熟练层——登录解锁画质、仓库模式去重、自定义命名、一键下载配置自动化。再加上一张配置文件速查表，你已经能覆盖日常 95% 的下载需求了。

现在，打开软件，把你收藏夹里吃灰的"稍后在看"列表拖进输入框，体验一把三分钟下完全部的感觉。遇到本文没覆盖的细节，比如多线程下载、音频编码优先级、代理与 hosts 配置，可以去项目的UPDATE.md更新日志和release/wiki/Q&A.md常见问题文档里找答案。

最后一句贴心提醒：下载内容请仅用于个人学习与收藏，尊重每一位 UP 主的创作劳动，别让工具变成搬运他人成果的捷径——把它当成整理自己知识库的帮手，这才是它最大的价值。

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