BiliDownload一步步实战把B站视频稳稳存进本地的完整指南【免费下载链接】BiliDownloadB站视频下载工具项目地址: https://gitcode.com/gh_mirrors/bil/BiliDownload副标题3步完成环境准备从零下载第一支视频再避开这些常见坑BiliDownload 是一款基于 Java 的B站视频下载工具通过调用 B 站 WEB 端与 TV 端 API支持从 360P 到 4K 的多档清晰度选择并优先获取无水印视频源。这篇教程会用一段真实的学习旅程带你从环境准备、首次下载、进阶玩法一路走到原理与排错全程配中文注释的命令示例照做即可。一、一个雨夜我的收藏夹少了一支视频上周三晚上十一点林小满照常打开自己的收藏夹准备复习一支讲版式设计的公开课。页面刷新后弹出一行冷冰冰的提示该视频已失效。她愣在原地。那支视频她追更了三个月UP主拆解了十几个真实案例笔记都做了一半。她翻了翻聊天记录发现群里至少有五个人转发过这支视频——而现在谁手里都没有备份。那天晚上她把收藏夹里剩下的两百多个视频挨个看了一遍每一支都像随时会消失。她忽然意识到一个此前从没想过的问题在B站收藏不等于拥有。你是不是也遇到过类似的场景精心挑选的教学内容想留到假期慢慢学想截取一段干净的素材做二次创作却发现画面角落里总有个水印或者系列课程太多只想把最需要的那几期存到本地。这时的你需要的不是一个复杂的视频网站而是一个趁手的下载工具。二、先说结论这个工具到底能帮你做什么BiliDownload 是一个用 Java 写成的命令行小工具体积轻、跨平台Windows、macOS、Linux 都能跑。它的定位很单纯把你输入的 AV 号或 BV 号对应的视频完整下载到本地。它最拿手的三件事多档清晰度可选从流畅 360P 到 4K 超清按需挑选大会员还能解锁更高画质优先无水印源工具会同时询问 B 站 WEB 端和 TV 端的接口如果 TV 端能给出无水印版本就会优先列出并标注无水印多 P 分集处理一个合集里有十几集它会先把每一集的标题、时长列给你再按你的选择逐一下载。如果只是偶尔存一两支视频或者要给系列课程做本地备份它都够用。当然下载的前提是你拥有观看该视频的权限——高清晰度内容需要登录对应账号这一点在后面的环节会反复提到。三、出发之前先把这三样东西备齐工欲善其事必先利其器。开跑之前先做个体检下面三样缺一不可我还附上了为什么需要。需要准备版本要求为什么需要它JDKJava 运行环境8 或更高BiliDownload 是 Java 程序没有它连程序都启动不了FFmpeg4.0 及以上视频和音频是分开下载的靠它合并成完整的 MP4磁盘空间至少留出视频体积的 1.5 倍合并前会同时存在临时视频、临时音频和最终文件先说一个真实教训FFmpeg 只在你选择视频音频合并时才用得上。如果你只选仅视频或仅音频不装 FFmpeg 也能跑。但既然来都来了建议一步到位把它装上——Ubuntu 系用sudo apt install ffmpegmacOS 用brew install ffmpegWindows 去官网下载后记得把目录加进系统 PATH。装好后在终端敲一句ffmpeg -version能打印版本号就说明它上岗了。四、第一次下载从敲下命令到看见视频文件环境就绪我们开始第一次完整流程。以下每一步都给出命令和中文注释。第一步获取项目。打开终端执行git clone https://gitcode.com/gh_mirrors/bil/BiliDownload # 克隆项目到本地 cd BiliDownload # 进入项目目录第二步编译打包可选但推荐。仓库里提供了源码用 Maven 一条命令就能打包出可执行 Jarmvn clean package # 编译并打包成功后 target 目录会生成 bili-download-1.3.6-jar-with-dependencies.jar第三步启动程序。输入java -jar target/bili-download-1.3.6-jar-with-dependencies.jar # 启动交互模式第四步跟着提示走完一次下载。程序是逐步问答式的你只管回答重点环节如下输入 AV 号或 BV 号——记得带上前缀比如BV1pK4y1N7gw。回车后程序会拉取稿件信息显示标题、UP主、时长、播放数、弹幕数等如果之前没登录过选择登录方式——有WEB 端二维码登录、TV 端二维码登录、输入 SESSDATA 登录三种。扫码登录最简单选二维码方式屏幕上弹出二维码窗口手机B站扫码确认即可程序每秒检查一次扫码结果如果视频有多个分P——程序会把每一集的 CID、时长和标题列出来你输入想下载的那一集的编号选择清晰度——比如1. 超清 4K、2. 高清 1080P……按需选数字选择下载选项——1. 视频音频合并需要 FFmpeg、2. 仅视频、3. 仅音频。想拿完整 MP4 就选 1并输入 FFmpeg 所在目录填#则跳过合并输入保存路径——建议直接给绝对路径路径不存在时程序会问你是否新建目录确认下载线程数——文件超过 8MB 时才会问。网速一般的话填 4~8别贪多原因见避坑章节等待进度条走完——下载时实时显示进度、平均速度和剩余时间完成后若选了合并会自动生成最终文件并清理临时文件。上面这张图就是一次真实下载过程输入 BV 号、选好 4K 清晰度、选择视频音频随后看到进度、速度与剩余时间逐秒跳动。当屏幕出现下载完成的提示去保存路径里翻一翻——你的第一支本地视频已经在手上了。五、过来人的三个小技巧批量、清晰度与一键直连走完一次流程你已经算入门了。下面这几个技巧是我自己踩过坑之后总结出来的能让效率再上一个台阶。技巧一系列课程批量下载提前写好答题卡。程序每一步都要输入但如果你想一次下完一个合集的十几集可以提前把答案按顺序写进工作目录下的Input.txt文件里每行一个输入。程序读取文件后会自动走完所有步骤全程无需人工值守——相当于给程序递了一张答题卡。这个技巧特别适合系列课程白天挂着让它慢慢下晚上回来验收成果。技巧二按用途选清晰度别总是顶格拉满。刚开始用工具时我习惯性选最高清晰度结果一个 45 分钟的教程占了 4 个多 G。后来我改成按用途分流要剪辑做二创的素材才用 1080P 或 4K单纯预览学习用 720P 完全够看文件体积却能小一半以上。下载前先问自己一句这支视频我拿来干嘛往往能省下不少硬盘空间。技巧三直接下载模式适合已拿到的视频直链。如果你手里已经有一条 B 站视频的真实直链比如从其他工具解析出来的 m4s 地址不需要走完整问答流程直接用直连模式java -jar target/bili-download-1.3.6-jar-with-dependencies.jar direct 视频URL 保存路径.mp4 # direct 模式第一个参数是直链第二个是保存文件名下载完自动退出批量脚本里循环调用这行命令就能把一批直链挨个存下来非常适合做素材批量归档。六、避坑速查常见问题的现象、原因与修复下面这些坑基本绕不开我用现象→原因→修复的方式列成速查表出了状况直接对号入座。现象原因修复办法下载进度卡住速度一直为 0网络抖动或线程数设置过高导致服务器拒绝报 416 错误减少线程数如填 3~4或等待程序自动重试仍不行就稍后再试下载完成却提示FFmpeg 合并失败或文件大小为 0FFmpeg 未安装 / 路径没配对 / 没有执行权限先敲ffmpeg -version验证在程序里输入 FFmpeg 所在目录的准确路径输入链接后提示解析失败、获取不到视频信息B 站接口临时调整或账号登录状态过期确认用最新版本重新扫码或重新粘贴 SESSDATA 登录某些清晰度选项不出现该清晰度需要大会员权限用拥有权限的账号登录再看一次清晰度列表二维码窗口不弹出或显示异常图形环境或终端限制改用输入 SESSDATA 登录浏览器 F12 打开开发者工具在 Cookie 里找到SESSDATA的值粘贴进去提示ArithmeticException: / by zero旧版本在特定场景下计算平均速度时除数为 0多见于瞬时速度为 0 时升级到 1.3.6 之后的版本该类问题已在更新中修复上图中的报错来自旧版本的一个除法异常属于典型的瞬时速度归零导致计算崩溃。如果你遇到类似堆栈先看一眼自己是不是旧版本升级往往比排查更省事。七、它背后的工作方式像快递分拣和接力一样你可能好奇一个输入 BV 号就能出结果的小工具内部到底发生了什么用大白话讲整个过程像一条分工明确的流水线。第一步是问路。你给出 BV 号程序就像打车前先查路线一样调用 B 站的接口把视频的元数据拿回来——标题、UP主、时长、有多少分P全都在这一步打包到手。第二步是领钥匙。B 站的视频不是你想下就下的程序得拿着你的登录凭证去换下载通行证也就是一条有时效的下载地址。WEB 端和 TV 端各有一把钥匙程序两把都试TV 端那把能开到无水印的房间就把无水印源优先排在你面前。第三步是分拣与接力。视频画面和声音在 B 站是分开存放的两份文件程序把它们分别取回再用 FFmpeg 像接力棒交接一样把画面轨和音轨合并成完整 MP4。这也是为什么大文件会问你线程数——相当于把一个快递包裹拆成多份交给几个快递员同时送最后再拼装起来。线程越多理论上越快但送件通道有限塞得太满反而会撞车也就是那个 416 错误。理解了这个流水线很多操作就不难解释了为什么登录是必须的拿钥匙、为什么高清要大会员钥匙权限、为什么选了合并就得配 FFmpeg最后一棒是它来跑。八、收尾把视频存下来也把创作留给作者林小满后来用这个工具把收藏夹里真正想留的视频都存了一份还养成了看到好内容随手归档的习惯。那个雨夜丢失的遗憾没有第二次发生。工具的价值是把看到变成拥有让优质内容不因平台波动而消失。但请记得一件事下载的视频请仅用于个人学习、研究或备份尊重每一位创作者的劳动成果。能用收藏表达喜爱就不要让下载变成搬运。最后给你一条最简命令作为起点java -jar target/bili-download-1.3.6-jar-with-dependencies.jar # 启动然后输入你的第一个 BV 号技术改变生活下载让知识长久地留在身边。祝你下载顺利 【免费下载链接】BiliDownloadB站视频下载工具项目地址: https://gitcode.com/gh_mirrors/bil/BiliDownload创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
