BBDown 快速入门：命令行离线下载 B 站视频教程
【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown
BBDown 是一个命令行式哔哩哔哩下载器：给它一条视频链接，它能完成片源解析、拉流下载与合并成 MP4 的完整流程。照下面的步骤走完，你会装好这个工具，并得到第一条真正存到本地的视频。
开工前自检：环境前提清单
动手前先确认三件事，任何一项不满足就先补齐，后面所有步骤才不会卡住。
| 待确认项 | 要求 | 自检命令 |
|---|---|---|
| .NET 运行时 | 8.0 及以上版本 | dotnet --version |
| ffmpeg | 合并音视频必需；杜比视界片源需 5.0 及以上 | ffmpeg -version |
| aria2c（可选） | 仅在想用 aria2c 加速下载时需要 | aria2c --version |
dotnet --version输出以 8 或更大数字开头的版本号，就可以继续。提示找不到命令，说明还没装 .NET SDK，从微软官方渠道装好再回来。ffmpeg 同理，装完后敲一下版本号，能打印出来即可。
dotnet tool 安装方式
BBDown 以 .NET 工具形式发布在 NuGet 上，一条命令装完：
dotnet tool install --global BBDown装完立刻验证：
BBDown --version终端打印出形如 x.y.z 的版本号，说明安装成功。日后要升级，执行dotnet tool update --global BBDown即可。
首次下载验证：最小示例
直接粘一条普通视频链接，不带任何额外参数：
BBDown "https://www.bilibili.com/video/BV1qt4y1X7TW"终端先列出解析出的标题和可用的音视频流，随后多线程开拉。结束后程序自动调用 ffmpeg 把音视频合并。回当前目录看，出现一个以视频标题命名的完整 .mp4 文件，首次下载就算跑通了。
三个高频场景命令
如果你只想留声音：存档播客或纯音频素材时，画面流纯属浪费，加一个参数直接跳过：
BBDown "https://www.bilibili.com/video/BV1qt4y1X7TW" --audio-only产物只有音频文件，体积大幅缩小。--danmaku-only、--sub-only、--cover-only同理，只分别取弹幕、字幕或封面。
当你要把整季番剧或整门课程搬下来：-p负责选集，-p ALL全量，-p 1,2,10挑单集，-p 1-10取区间：
BBDown -p ALL "https://www.bilibili.com/bangumi/play/ss33073" --download-danmaku --delay-per-page 2每集之间停 2 秒，既减轻服务器压力也降低触发风控的概率，弹幕同步存成 xml。习惯固定下来更好：在程序目录新建BBDown.config，把想默认生效的参数写进去，以后每次只贴链接：
--file-pattern <videoTitle>[<dfn>] --delay-per-page 2文件名可用<ownerName>、<publishDate>、<res>等占位符自由组合。
如果你想把它挂成服务跑：BBDown 可以以服务器模式启动，对外暴露 HTTP 接口，从/add-task提交下载任务、从/get-tasks查询进度，再接个 Web 面板就能自建管理台：
BBDown serve -l http://0.0.0.0:12450接口字段的具体说明见仓库内的 json-api-doc.md。
故障速查表
| 现象 | 原因 | 解法 |
|---|---|---|
| 下载完只剩零散的音视频流 | ffmpeg 没装或不在 PATH | 装上 ffmpeg；仍找不到时用--ffmpeg-path指向可执行文件 |
| 高画质或付费内容下不动 | 当前账号缺少对应权限 | BBDown login扫码登录，或用-c "SESSDATA=..."带网页 cookie |
| 杜比视界片源混流失败 | ffmpeg 版本低于 5.0 | 升级 ffmpeg，或改用--use-mp4box让 MP4Box 混流 |
| 分 P 列表看不到全貌 | 分 P 过多时列表默认折叠 | 加--show-all展开全部标题 |
| 只想预览有哪些流 | 默认行为是解析完直接下载 | 加-info仅解析，看完再决定是否下载 |
收尾：带走一条通用命令
一条命令装、一条命令下，整套离线缓存流程到此就位。下次要存视频，直接复制这行、换上自己的链接就能跑：
BBDown "你正在看的视频链接"【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
