BiliDownloader 1.4.0使用流程：从BV号到本地文件，按阶段排查问题

BiliDownloader 1.4.0使用流程：从BV号到本地文件，按阶段排查问题

用BiliDownloader保存B站视频，可以把任务拆成四段：解析编号、确认内容、设置下载参数、检查本地结果。这样做的好处是出现异常时知道该查哪一层，而不是反复换安装包或重新登录。

本文按1.4.0的官方使用说明与更新记录整理。它是Majjcom开发的Windows图形界面工具，支持BV、AV、MD、EP号输入，再经过选集、清晰度和编码选择提交下载。1.4.0发布于2026年9月19日，主要变化集中在下载模块与任务操作。

一、先区分发行包和源码环境

官方这一版的实际成品附件是四个7z压缩包：Installer、Portable310、Portable312、Portable38。Installer对应安装形式，Portable对应便携形式。310、312等尾缀与项目使用的Python版本背景有关，不是处理器位数，也不是Windows版本号。

普通使用优先按自己的部署习惯选成品包。安装版需要先解压外层压缩包，再使用包内安装程序；便携版则保持解压后的文件结构，从包内入口启动。不要只把看起来像主程序的单个文件复制出去，否则会改变发行包预期的目录结构。具体入口以解压后的实际内容为准。

源码运行是另一条路线。构建指南的直接运行部分写有Python不低于3.10、Windows不低于10，还涉及依赖与ffmpeg准备。拿到现成发行包，无需逐条执行源码构建命令。便携包则有不同变体：更新记录说明后来增加了Python3.12版本，默认仍为3.10。这段源码环境要求不能用来判断每个便携包的最低系统版本，选择包时应把运行方式与环境版本分开核对。

如果使用的是32位PC，应先停止按当前发行包尝试：项目自1.3.0起已取消这类支持。Linux虽然有单独构建说明，但本版附件中没有Linux成品包；不能把Windows压缩包换个启动命令，就当成跨平台程序。

二、配置目录与登录状态

打开软件后，先进入设置页指定下载位置。建议选一个明确的测试目录，确认磁盘空间与写入条件，再进行第一条任务。暂时不要把多批内容都指向难以区分的公共目录，否则出现遗漏时不容易核对。

默认路径与临时路径的用途不同：设置页负责以后常用的默认位置，任务参数页允许本次临时修改。若发现文件没出现在预期目录，先回想提交前是否改过临时路径，不要立即认定软件没有保存。下载前把目录记清楚，是后续验证的起点。

需要登录时，在设置页通过二维码完成。某些视频的完整内容与部分清晰度需要大会员权限，必须使用具备相应资格的账号。这里的登录解决访问条件，不是提升所有视频规格的开关；视频本身未提供的画质不会因为登录而出现。

项目较早的更新记录还调整过登录信息保存方式，新的登录不支持通过简单复制配置文件转移到别的设备。因此换电脑后，应按软件入口重新处理账号状态，别把旧设备配置当成可通用迁移的登录凭据。

三、输入编号后，先确认解析对象

输入页支持视频编号或相应链接，明确列出的编号类型是AV、BV、MD和EP。MD通常出现在番剧详情页，EP用于具体剧集。第一次操作可以直接使用完整编号，减少链接中额外内容带来的辨认负担。

界面设计：Majjcom。图示为早期输入页，后续步骤以当前版本显示为准。

进入下一步后，先检查解析到的视频信息，再选择需要的分集。编号匹配不等于任务范围一定正确：单集、系列中的多集、不同投稿的相似标题，都应该在确认阶段分清。只需要其中几节，就只勾相应条目。

初次验证不宜同时改变太多条件。可以先选一条有权限访问的内容，保留容易识别的保存路径；完成这条后，再扩大选集范围。如果一开始便混合多种内容和多个输出要求，即使失败也难以判断是哪项设置造成的。

四、把清晰度、编码、路径分别核对

选集完成后的参数页允许选择视频清晰度、视频编码，并临时修改保存位置。清晰度影响目标画面规格，编码影响文件的压缩方式及播放端的支持要求。它们需要分别判断，不能用“都选最新”代替选择。

若准备把视频交给另一台设备播放，先用同一编码下载一个短任务并在那台设备验证。电脑端能打开，不代表目标设备的播放器一定支持。出现只有声音、画面异常或打不开时，先记录选用的编码与播放器，再判断是否需要换一种可选组合。

画质列表也要结合资源和账号理解。某档选项不可用，应先核对源视频是否具备该档，以及登录账号是否有资格；重装软件无法改变这两个条件。把“解析不到视频”和“没有想要的清晰度”分别描述，后续排查才有方向。

仅需声音时，可以关注项目已有的“仅下载音频”功能。它适用于画面不承担关键内容的情况；依赖屏幕演示的课程只留音轨，往往无法完整使用。音频方案应由内容决定，而不是单纯为了减少文件数量。

五、任务中断时，先定位阶段

1.4.0更新了下载模块，作者列出了暂停、重试等操作，并修复重试后进度条闪烁的问题。遇到任务中断时，优先查看当前任务提供的状态与操作。暂停、重试的具体入口以当前版本显示为准，早期截图不能说明当前每个按钮的位置；“支持重试”也不意味着所有异常都能自动恢复。

可以按下面的顺序记录现象：

• 编号提交后没有得到目标内容：核对编号类型、目标对象与确认页信息。
• 已识别内容，但缺少清晰度：核对原视频规格和账号访问条件。
• 任务已加入但停止推进：查看下载状态，记录提示及重试后的变化。
• 文件已经出现但不能播放：核对是否完成，以及编码与目标播放器的组合。

这些是定位思路，不是每一种错误的确定修复。反馈问题时，至少带上软件版本、所选发行包、发生阶段和实际提示，避免只留下“下载不了”。账号信息、二维码和个人凭据不应一起公开。

六、完成后的验证方法

先在本次设置的目录中核对文件数量，再抽查分集是否选对。播放检查可覆盖开头、中段和结尾，同时确认是否存在声音。若任务目的是离线学习，再检查仅靠当前保存内容是否能跟上讲解，别等到需要使用时才发现缺少相关分集。

README中保留了一些早期说明，后续日志又增加过音频解析能力，杜比相关表述存在时间差。对这些特殊规格应按实际选项与结果判断，不把过时句子或单条更新说明当成全场景保证。普通首次验证从常规视频任务开始即可。

把第一条任务走通后，记录自己已经确认可用的保存位置、编码与播放端。下一批遇到问题时，用这组条件作为对照，逐项变动，比同时切换账号、包版本和全部参数更容易找到原因。

GitHub仓库：Majjcom/BiliDownloader

下载与获取

• 百度网盘:https://pan.baidu.com/s/1v47SEnSUDn-fswF7Y5eDHg?pwd=ojj4 提取码:ojj4
• 夸克网盘:https://pan.quark.cn/s/5ac34bc22e1e