一、项目介绍
1.1 这是什么
Bili23 Downloader 是一款开源、免费、跨平台的哔哩哔哩（B 站）视频下载工具。它支持 Windows（含 Win 7）、Linux 和 macOS 三大桌面操作系统，提供多线程加速下载、音视频自定义、弹幕字幕获取、封面嵌入、媒体元数据刮削、自定义命名与分类存储等一整套完整能力。
与市面上大量夹带广告、捆绑安装甚至收费限速的"下载器"不同，Bili23 Downloader 基于 GPL-3.0 协议完全开源，无内购、无广告、代码完全透明。项目由开发者 Scott Sloan 利用业余时间独立开发维护，自开源以来持续高频迭代（已有 1370+ 次提交），目前最新版本为 2026 年 7 月 16 日发布的 v2.11.0。
项目地址：https://github.com/ScottSloan/Bili23-Downloader
官网地址：https://bili23.scott-sloan.cn
许可证：GPL-3.0
最新版本：v2.11.0（2026-07-16）
1.2 为什么值得关注
经常逛 B 站的人多少都遇到过这些需求：想离线保存一期教程反复观看、想把 UP 主的整个合集批量归档、想把弹幕和字幕一起存下来、想给家里老人下载戏曲视频离线播放……B 站官方客户端的缓存功能存在加密限制、无法导出、画质受限等问题，而 Bili23 Downloader 恰好补齐了这块短板：
解析能力强：不只是单个视频，番剧、课程、UP 主空间、收藏夹、每周必看、订阅合集、追番追剧、稍后再看、历史记录等十几种链接类型都能解析，且支持批量处理；
下载质量高：最高支持 8K、4K、HDR、杜比视界画质，Hi-Res 无损、杜比全景声音质，AVC / HEVC / AV1 三种编码任选；
媒体库友好：自动下载弹幕、字幕、封面，还能生成 Kodi / Jellyfin / Emby 等媒体中心标准的 NFO 元数据文件，方便搭建本地影音库；
工程素养在线：Fluent Design 现代 UI、浅色/深色主题切换、多线程 + 断点续传 + 异常自动重试，体验不输商业软件。
核心功能一览
1.4 技术栈
项目使用 Python 开发，界面层于 2026 年 3 月完成了一次大规模重构：从原有框架切换到 PySide6 + QFluentWidgets，这也是其 Fluent Design 风格界面的来源。wbi 签名、部分接口及 buvid3 参数生成参考了知名的开源项目 SocialSisterYi/bilibili-API-collect。
1.5 重要：使用协议与版权提醒
在使用前，有几点必须明确（这也是项目的官方使用协议）：
本项目仅供个人学习与研究用途，下载内容仅限于个人非商业使用，严禁用于任何形式的商业目的、公开传播或分发；
软件仅基于用户账号的合法访问权限操作，不会绕过任何付费墙或平台知识产权保护措施——大会员内容你需要有大会员，付费课程受 DRM 保护的部分无法下载；
用户需自行承担使用风险（包括账号封禁、版权纠纷等）。
请尊重创作者版权，下载内容仅供个人离线观看，不要二次上传或传播。
二、Windows 详细使用教程
2.1 第一步：下载安装包
当前最新版本为 v2.11.0（2026-07-16 发布）。Windows 平台提供三种安装包，请根据自己的系统版本选择：
下载渠道（三选一）：
GitHub Releases：访问 https://github.com/ScottSloan/Bili23-Downloader/releases/latest ，在 Assets 中选择对应文件，适合访问 GitHub 较稳定的用户；
官网下载页：访问 https://bili23.scott-sloan.cn/doc/releases.html ，提供 GitHub 与蓝奏云两种镜像，国内用户推荐，速度更快更稳定；
蓝奏云镜像：
版本选择建议：
大多数用户（Win 10/11）：直接下载
windows_x64.exe安装包；不想安装、或需要放在 U 盘里随身携带：选择
windows_x64_portable.zip便携版；Win 7 或非常老的 Win 10 系统：务必下载带
for_win7字样的兼容版，否则程序无法运行。
2.2 第二步：安装与首次启动
exe 安装包：
双击运行下载好的
.exe文件（程序使用 Inno Setup 打包）；按向导提示选择安装路径，一路"下一步"即可完成安装；
安装完成后从开始菜单或桌面快捷方式启动程序。
zip 便携版：
将下载的
.zip解压到你希望存放的目录（路径建议不要包含中文或特殊字符）；双击解压目录中的主程序即可运行，无需安装。
💡 如果 Windows SmartScreen 或杀毒软件弹出安全提示（开源软件未购买商业代码签名证书时较常见），确认安装包来自上述官方渠道后，选择"仍要运行"即可。
2.3 第三步：登录 B 站账号（强烈建议）
这一步非常重要：未登录状态下，B 站接口最高仅允许获取 480P 画质的视频。登录后才能解锁高画质解析。
软件支持三种登录方式：
扫码登录（推荐）：在软件内打开登录窗口，使用手机 B 站 App 扫码确认即可，安全快捷；
短信验证登录：输入绑定手机号，接收验证码完成登录；
Cookie 登录：v2.11.0 新增，适合熟悉浏览器操作的高级用户手动导入 Cookie。
登录后，你能下载的内容权限完全取决于你的账号状态：大会员账号可下载大会员专享内容，普通账号则只能下载公开内容。软件不会也无法绕过任何付费墙。
2.4 主界面概览
程序启动后分为四大核心功能区，通过侧边栏标签导航切换：
解析页：粘贴视频链接并获取可下载列表，是程序的默认首页；
下载页：集中追踪下载进度，管理正在下载和已完成的任务；
收藏页：查看登录账号的收藏夹、订阅合集、追番追剧、稍后再看、历史记录；
设置页：自定义保存路径、画质优先级及其他软件运行行为。
2.5 核心下载流程：三步搞定
第一步：粘贴链接解析
在首页的链接输入框内粘贴想要下载的 B 站链接，点击 【解析】 按钮。支持解析的链接类型包括：
常规投稿：单个视频、分 P 视频、合集视频、互动视频；
影视综类：番剧、电影、纪录片、国创、电视剧、综艺；
精选栏目：每周必看；
聚合目录：公开收藏夹、UP 主个人空间、追番追剧、订阅合集、稍后再看、历史记录；
其他格式：付费课程（仅限未 DRM 加密部分）、
b23.tv短链接。
第二步：勾选与确认
解析完成后，勾选列表中需要下载的视频复选框，点击右下角的 【下载所选项目】。此时会弹出下载选项对话框，可预览媒体预估大小，并根据需要临时微调该批任务的参数（例如强制选择 H.264 编码）。确认无误后点击 【确认】，任务即加入下载队列。
第三步：等待下载完成
切换到 【下载页】，实时查看网速与单个任务进度。下载完成的文件会保存到你设置的路径中。
2.6 批量下载进阶技巧
面对包含成百上千个视频的大型合集（比如 UP 主空间或收藏夹），逐个勾选效率太低，可以使用这些高级功能：
搜索定位：点击解析按钮下方的"更多选项"图标，打开搜索对话框，输入关键词后解析列表会高亮显示相关项；
快捷键：在列表范围内按
Ctrl + A全选，Ctrl + D取消全选；划定范围选择：在"更多选项"中打开批量选择对话框，输入行号范围（如
1-5,7,9-12），一键圈选对应序列；点击表头排序：直接点击解析列表顶部的列标题（序号、时长、发布时间等），即可按该属性排序，再次点击可在升序/降序间切换。
2.7 下载任务管理
在 【下载页】 中，右键点击任意下载任务可呼出功能菜单，随时进行 暂停、恢复、彻底删除或重新下载 操作。程序内置多线程下载、断点续传与网络异常自动重试机制，网络波动时无需手动干预。v2.11.0 还支持记忆下载列表的筛选设置，无需每次重新设置。
2.8 收藏页联动：告别复制粘贴
切换到 【收藏页】（需已登录），可以直接读取你的个人内容资产：
自己创建的收藏夹、稍后再看、近期历史记录；
追番追剧列表与订阅合集。
找到想下载的内容时，只需点选对应卡片，程序会自动提取底层链接并跳转到 【解析页】 进行解析，完全省去切回浏览器复制链接的麻烦。
2.9 个性化设置详解
切换到 【设置页】，建议首次使用时花几分钟完成以下配置：
基础设定
保存路径：修改默认的文件保存位置（建议选一个空间充足的磁盘分区）；
命名规则：自定义文件命名模板与多级目录分类存储方式——如果你觉得"下载的视频外面多了一层文件夹"或"视频顺序不对"，就是命名规则的问题，在这里按喜好调整即可；
并发下载数量：设置同时进行的下载任务数。
媒体规则
画质优先级：配置首选的最高画质（8K / 4K / HDR / 1080P 等）；
音质优先级：Hi-Res 无损、杜比全景声等；
编码优先级：AVC（H.264）/ HEVC（H.265）/ AV1 三者可拖拽排序。如果下载的视频在系统自带播放器里无法播放或只有声音没有画面，把兼容性最广的 AVC 拖到列表顶部再重新下载即可解决。
附加元数据
是否自动下载并转换弹幕（XML / ASS）；
是否下载外挂字幕（srt / lrc / txt / ass / json）；
是否保存封面图并嵌入视频文件；
是否生成 NFO 媒体信息文件（供 Kodi / Emby / Jellyfin 等媒体中心刮削）；
输出封装格式：mp4 或 mkv。
界面与显示
浅色 / 深色主题切换；
界面显示缩放比例（Win 7 用户如果感觉界面过小、字体模糊，可在此调大缩放比例）。
三、常见问题（FAQ）
Q1：为什么我只能下载 480P 画质的视频？
未登录状态下 B 站接口限制最高只能获取 480P。请在软件内登录你的哔哩哔哩账号后再解析下载。
Q2：为什么不能下载大会员专享、充电专属或付费视频？
软件不支持也绝不会绕过任何付费墙，可获取的内容权限完全取决于你登录账号的状态。请确认账号已开通大会员或已购买对应内容。
Q3：已购买的课程为什么下载不了？电影/纪录片为什么没有 4K？
部分受严格版权保护的商业内容受 DRM（数字版权管理）加固保护：电影/纪录片通常最高只能下载未加密的 1080P 版本；绝大部分付费课程受完整 DRM 保护，完全无法下载。
Q4：提示"解析失败（412 Precondition Failed）"怎么办？
这是短时间内频繁解析/下载触发了 B 站风控。解决方法：暂停使用数小时至半天，风控会自动解除；急需下载时可重启路由器更换 IP，或改用手机热点。
Q5：下载的视频无法播放，或只有声音没有画面？
视频采用了 AV1 或 HEVC 编码，而系统自带播放器缺少解码器。解决方法二选一：① 换用 PotPlayer、VLC 等支持全格式解码的播放器（推荐）；② 在设置中把 AVC（H.264）编码拖到优先级顶部，重新下载。
Q6：下载的视频外面多了一层文件夹 / 顺序是乱的？
这是预设命名规则导致的，在设置页中按个人喜好修改命名规则即可。
Q7：下载的视频有水印，能去除吗？
不能。水印本身是视频画面的一部分，除非 UP 主上传时未添加，否则无法去除。
Q8：Windows 7 用户无法运行程序？
请到下载页选择带 for_win7 字样的 Windows 7 兼容版安装包。若 Win 7 下界面过小、字体模糊，在设置中调大显示缩放比例即可。
Q9：能下载抖音、快手、小红书等其他平台的视频吗？
不能。本软件专为哔哩哔哩平台设计，无法解析其他平台的视频。
四、总结
Bili23 Downloader 是目前体验最完善的 B 站下载工具之一：开源免费、无广告、跨平台，解析类型覆盖全面，画质音质上限高，弹幕字幕封面与 NFO 元数据一应俱全，还有持续活跃的版本迭代（v2.11.0 刚刚带来了 Cookie 登录与多项稳定性修复）。对于需要离线保存学习资料、批量归档 UP 主内容、搭建本地媒体库的用户来说，它值得成为你的常备工具。
最后再次提醒：请通过官方渠道下载安装包，登录自己的账号使用，下载内容仅限个人非商业用途，尊重创作者版权。如果这款工具帮到了你，不妨去 GitHub 仓库给作者点一颗 Star ⭐。
相关链接