当前位置：首页 > news >正文

BilibiliDown：从零开始打造你的B站视频离线图书馆

news 2026/7/7 17:19:10

BilibiliDown：从零开始打造你的B站视频离线图书馆

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

你是否曾经遇到过这样的烦恼：在B站发现了一个超棒的教学视频，想要离线保存反复学习，却发现网站没有提供下载功能？或者收藏夹里堆满了优质内容，却只能在有网络时观看？今天，我要和你分享一个秘密武器——BilibiliDown，这款开源工具能让你轻松将B站视频变成个人数字资产。

初识BilibiliDown：不只是下载工具

BilibiliDown不仅仅是一个简单的视频下载器，它是一个完整的B站内容管理系统。想象一下，你可以在本地建立一个分类清晰、易于检索的视频图书馆，无论何时何地都能访问你最爱的B站内容。这款基于Java开发的开源工具，以其跨平台特性（支持Windows、macOS和Linux）和强大的功能集，正在成为B站用户必备的离线内容管理神器。

项目架构解析：模块化设计的智慧

让我们先了解一下BilibiliDown的技术架构。整个项目采用模块化设计，主要分为以下几个核心模块：

解析模块：位于src/nicelee/bilibili/parsers/impl/目录下，包含各种链接解析器，能够处理不同类型的B站链接，从单个视频到收藏夹、UP主主页等复杂场景。
下载模块：在src/nicelee/bilibili/downloaders/impl/中实现，支持多种视频格式和清晰度，采用多线程技术确保下载效率。
UI模块：基于Swing构建的图形界面，提供直观的操作体验，让技术小白也能轻松上手。
配置系统：通过config/app.config文件实现高度可定制化，让你完全掌控下载行为。

实战演练：从安装到精通

第一步：环境准备与快速启动

首先，你需要获取BilibiliDown的源代码或可执行文件。最直接的方式是通过Git克隆项目：

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

如果你是技术爱好者，可以查看项目的Java源码结构；如果只是想快速使用，可以直接运行release目录下的可执行文件。软件自带Java运行时环境，无需额外配置Java开发环境。

首次启动时，你会看到一个简洁的主界面：

界面采用B站标志性的蓝白配色，右上角有登录入口，中央是视频链接输入框。整个设计既美观又实用，让人一眼就能看出这是为B站用户量身打造的工具。

第二步：账号登录与权限获取

要访问个人收藏夹、稍后再看列表等私有内容，你需要登录B站账号。BilibiliDown采用安全的二维码登录方式，无需输入密码，保护你的账号安全。

点击右上角的登录按钮，会出现二维码扫描界面：

使用手机B站APP扫描二维码即可完成登录。整个过程完全在本地进行，登录凭证明文保存在config/cookies.config文件中，你可以随时删除或通过软件内的"退出登录"功能清除。

第三步：视频下载实战

现在让我们开始真正的下载之旅。假设你找到了一个想保存的视频，操作流程非常简单：

复制视频链接：在B站视频页面复制地址栏的URL
粘贴并解析：将链接粘贴到BilibiliDown的输入框中，点击"查找"按钮
选择清晰度：软件会显示视频的详细信息，包括封面、标题和可用的清晰度选项

开始下载：选择合适的清晰度，点击下载按钮

软件支持从流畅（360P）到超清（4K）的完整画质选择，还能单独提取音频。下载过程中支持断点续传，即使网络中断也能从断点处继续，避免重复下载。

高级功能探索：批量处理的艺术

批量下载收藏夹内容

BilibiliDown最强大的功能之一是批量下载。想象一下，你关注了一个优质UP主，他有上百个视频作品，传统方法需要逐个下载，而使用BilibiliDown只需几个简单步骤：

登录你的B站账号
进入收藏夹或UP主主页，复制页面链接
在BilibiliDown中选择"批量下载"模式

你可以设置下载策略（仅第一个、全部下载）、优先清晰度等参数，软件会自动识别页面中的所有视频并进行批量处理。这个功能对于建立个人学习资料库或收藏喜爱的UP主作品特别有用。

自定义文件命名规则

BilibiliDown提供了灵活的文件命名配置，让你的下载文件井井有条。打开config/app.config文件，你可以看到详细的命名规则配置：

# 基础命名变量 # avId - bv号 e.g. BV1BJ411E7uM # numAvId - 老的数字av号 e.g. av1234567 中的1234567 # pAv - av 的第几个视频 e.g. p1/p2 # avTitle - av标题 # clipTitle - 视频小标题 # UpName - 阿婆主的名字 # qn - 清晰度值 e.g. 32/64/80 # 示例配置：按UP主分类，包含清晰度和视频ID bilibili.name.format = UpName/avTitle-pAv-qn(avId) # 条件命名：当有收藏夹名称时，在文件名前添加 bilibili.name.format = (:listName listName/)avTitle-pAv2-qn

这种灵活的命名系统让你可以根据自己的整理习惯定制文件结构。比如，你可以按UP主分类，或者按视频发布时间组织，甚至可以设置复杂的条件命名规则。

配置优化：打造个性化下载体验

性能调优配置

根据你的网络环境和硬件配置，可以调整以下参数以获得最佳下载体验：

# 同时下载任务数，根据网络带宽调整（默认3） bilibili.download.poolSize = 5 # 下载失败重试次数 bilibili.download.maxFailRetry = 3 # 多线程下载配置 bilibili.download.multiThread.count = 4 bilibili.download.multiThread.minFileSize = 50 # 文件大于50MB时启用多线程

存储路径管理

默认情况下，下载的文件保存在download/目录下。你可以在配置文件中修改保存路径：

# Windows用户示例 bilibili.savePath = D:/B站视频/ # macOS/Linux用户示例 bilibili.savePath = /Users/用户名/Bilibili下载/

视频格式选择

BilibiliDown支持多种视频格式，你可以根据需求选择：

# 0: MP4(合并分离的音视频) - 推荐，兼容性好 # 1: FLV - 旧格式，某些场景可能有用 # 2: MP4(直接下载mp4, 但清晰度无法选择) bilibili.format = 0

常见问题与解决方案

下载速度慢怎么办？

如果你遇到下载速度慢的问题，可以尝试以下优化：

调整同时下载任务数：减少bilibili.download.poolSize的值，避免网络拥堵
检查网络连接：确保没有其他大流量应用在运行
避开高峰期：B站服务器在晚上和周末可能较忙
配置代理：如果需要，可以在配置中设置代理服务器

某些视频无法下载？

如果某些视频无法下载，可能是以下原因：

需要登录：会员专享或地区限制内容需要登录B站账号
API变更：B站接口更新可能导致暂时无法下载，等待软件更新
版权保护：受特殊版权保护的内容可能无法下载

FFmpeg相关问题

BilibiliDown使用FFmpeg进行视频处理。软件自带精简版FFmpeg，一般无需额外安装。如果遇到转码问题：

检查FFmpeg路径配置是否正确
从官网下载完整版FFmpeg并配置路径
在配置文件中指定FFmpeg位置：bilibili.ffmpegPath = /path/to/ffmpeg

项目管理与社区参与

开源协议与贡献

BilibiliDown采用Apache 2.0开源协议，这意味着你可以自由使用、修改和分发软件。项目位于GitCode平台，欢迎开发者参与贡献。

如果你想为项目做贡献，可以从以下几个方面入手：

问题反馈：在项目issue页面报告bug或提出功能建议
代码贡献：熟悉Java开发，可以参与功能开发和优化
文档完善：帮助改进使用文档和教程
测试验证：在新版本发布前进行测试

项目结构概览

了解项目结构有助于更好地使用和贡献代码：

BilibiliDown/ ├── src/ # 源代码目录 │ ├── nicelee/bilibili/ # 核心业务逻辑 │ ├── nicelee/ui/ # 用户界面 │ └── nicelee/server/ # 服务器相关 ├── config/ # 配置文件 ├── release/ # 发布文件 └── libs/ # 依赖库