一文讲透 BBDown：B站视频下载器实操手册
【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown
整理 B 站上一套老教程的时候，我想把全套视频连字幕带分 P 标签存到本地，用了几种浏览器方案，要么带水印，要么多 P 处理得很麻烦。BBDown 是一款命令行式的哔哩哔哩下载器，解决的就是"把 B 站内容干净利落地落到本地磁盘"这件事。
一句话定位
BBDown 是一个基于 .NET 9 的免费命令行下载工具，发布形态本身就是 .NET tool，不用 clone 源码。它和同类工具的差异在接口覆盖：Web、TV、APP、国际版四套解析器并存，画质一路开到 8K、HDR 真彩和杜比视界，这些高档位片源走的是 TV/APP 接口才拿得到。
核心能力速览
平时我在用它，用得最多的能力集中在这几项：
- 内容类型全：普通视频、番剧（ep/ss）、课程（cheese）、收藏夹、合集、UP 主空间，URL 直接丢进命令行，内部
FetcherFactory按前缀自动路由到对应解析器 - 高码率片源：
-q "8K 超高清, 杜比视界"可以按清晰度优先级选择，-e "hevc,av1,avc"按编码偏好排序 - 分 P 与批量：
-p 1,3,5-10支持单 P、多 P、区间三种写法，-p ALL整季带走 - 资源分离：
--danmaku-only、--sub-only、--audio-only可以只取弹幕、字幕或音频，不下载整个视频 - serve 模式：跑成 HTTP 服务后，加任务、查状态、清历史全走 JSON 接口，方便写脚本
三行命令跑通首次下载
装好 dotnet 环境后，两条命令就能出 mp4：
dotnet tool install --global BBDown BBDown "https://www.bilibili.com/video/BV1qt4y1X7TW"首次运行会先打印解析出的分 P 和可用流信息，然后多线程下载、用 ffmpeg 混流成单个文件。完整参数表直接看BBDown --help或 README.md，不必背。
一个参数换无水印片源
网页版 mp4 右上角自带台标水印，剪辑二创前都得裁一版画幅。加-tv参数切到 TV 端接口：
BBDown -tv "https://www.bilibili.com/video/BV1qt4y1X7TW"我实测下来，粉丝量较大的 UP 主，TV 源基本无水印，清晰度档位也比 Web 端全。番剧同理，季节链接配-p ALL就是整季无水印下载。
serve 模式：把它当下载队列用
另一个辨识度高的是服务化。启动后它在本机起一个 HTTP 服务：
BBDown serve -l http://0.0.0.0:12450GET /get-tasks/列全部任务，POST /add-task只传一个Url字段就能入队，GET /remove-finished清掉跑完的。我的用法是写个小脚本把收藏夹列表逐条 POST 进去，挂机过夜，第二天看/get-tasks/finished的结果。
先踩这三个坑能省不少事
混流依赖外部 ffmpeg（或 mp4box），没装的话只会得到视频流、音频流两个分离文件，杜比视界混流要求 ffmpeg 5.0 以上。
- 会员内容要登录：
BBDown login/logintv扫码即可；Windows 上扫码报Gdip初始化异常，是 System.Drawing 依赖问题，参考项目 issue #37 处理 - 常用参数写进配置文件：1.4.9 起程序会读同目录的
BBDown.config，选项一行、参数下一行：
# BBDown.config --file-pattern <videoTitle>[<dfn>] --delay-per-page 2 --download-danmaku- 批量下载限速：合集分 P 之间用
--delay-per-page 2插间隔；--save-archives-to-file可以把已下载记录落盘，重跑同一链接时自动跳过
该不该选它
如果你的需求是命令行、高码率、无水印、批量自动化，BBDown 目前是这个场景里完成度最高的选择之一，配置文件加 serve 模式基本能覆盖挂机下载的全部诉求。反过来，如果你想在多个视频平台之间通用，或者习惯图形界面点来点去，它就不合适——没有 GUI，交互全靠命令行和那一个配置文件。
下一步
先跑dotnet tool install --global BBDown试一个单 P 视频，确认 ffmpeg 混流正常；然后打开 json-api-doc.md 过一遍 serve 模式的字段定义，把批量脚本搭起来。
【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
