3分钟上手BBDown：零基础安装与下载第一个B站视频的完整教程
【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown
BBDown 是一个免费、开源的命令行式哔哩哔哩下载器（Bilibili Downloader）。只需一行命令，它就能把 B 站视频解析、下载并自动合并成 MP4，还支持番剧、合集、弹幕、字幕，甚至 8K 和杜比视界画质。本教程面向零基础用户，带你 3 分钟完成安装并下载人生第一个 B 站视频。
🧩 为什么选择 BBDown？
和普通网页插件不同，BBDown 直接走 B 站官方接口，功能非常全面：
| 能力 | 说明 |
|---|---|
| 多内容支持 | 普通视频、番剧、课程、合集、收藏夹、个人空间 |
| 高质量下载 | 支持 8K / HDR / 杜比视界 / 杜比全景声 |
| 自动混流 | 视频流 + 音频流 + 字幕自动合并为 MP4 |
| 灵活控制 | 可选分 P、选清晰度、多线程下载、自定义文件名 |
| 扫码登录 | 支持 WEB / TV 端账号鉴权 |
它基于 .NET 9 开发（见 BBDown.csproj），已打包为官方 .NET Tool，安装极其方便。
🚀 安装 BBDown：3 种方式任选其一
方式一：dotnet tool 一键安装（推荐 ⭐）
如果你电脑上装有 .NET SDK（Windows / macOS / Linux 均可），一条命令搞定：
dotnet tool install --global BBDown后续升级也只需：
dotnet tool update --global BBDown💡 没有 .NET 环境？没关系，看方式二。
方式二：直接下载 Release 预编译包
不想装任何运行环境的话，可以直接到项目的Releases页面下载对应系统（Windows / macOS / Linux）的压缩包，解压后得到一个独立的BBDown可执行文件，双击或终端运行即可，无需安装。
方式三：Docker 一键部署 API 服务器
如果你想在服务器上搭建一个可访问的下载接口，项目自带 Dockerfile，已经内置了 ffmpeg，镜像启动后直接以serve模式监听 23333 端口（见 Dockerfile）。API 的用法可参考 json-api-doc.md。
🎬 安装 ffmpeg：BBDown 混流必备
BBDown 下载音视频后需要外部工具把两路流合并成 MP4，它会调用ffmpeg或mp4box（混流逻辑见 BBDownMuxer.cs）。
Windows：
winget install ffmpegmacOS：
brew install ffmpegLinux：
sudo apt-get install ffmpeg装好后确认能运行：ffmpeg -version能输出版本号即可。
📥 下载你的第一个 B 站视频
打开终端，粘贴以下命令（把 URL 换成任意视频地址）：
BBDown "https://www.bilibili.com/video/BV1qt4y1X7TW"执行过程大致是：
- 解析视频信息—— 显示标题、UP 主和所有可用清晰度；
- 多线程下载—— 视频流 + 音频流同时拉取；
- 自动混流—— 调用 ffmpeg 合并出带字幕和章节信息的 MP4；
- 保存完成—— 文件默认保存在当前目录，命名为视频标题。
🎉 恭喜你，第一个 B 站视频已经躺在你的硬盘里了！
⚡ 新手必知的 6 个常用参数
| 参数 | 作用 | 示例 |
|---|---|---|
-p | 选择分 P（单个/多个/范围） | BBDown -p 1-10 "<url>" |
-q | 指定画质优先级 | BBDown -q "1080P 高码率" "<url>" |
-dd | 同时下载弹幕 | BBDown -dd "<url>" |
-ia | 交互式选择清晰度 | BBDown -ia "<url>" |
-tv | 使用 TV 端接口（大 UP 主通常无水印） | BBDown -tv "<url>" |
--video-only | 只下视频不要音频 | BBDown --video-only "<url>" |
完整参数列表随时可用BBDown --help查看。
偷懒技巧：用配置文件免输入
1.4.9 版本起支持BBDown.config配置文件，程序启动时会自动读取同目录下的配置（解析逻辑见 BBDownConfigParser.cs）。例如设置文件命名格式和弹幕下载：
#本文件是BBDown程序的配置文件 #以#开头的都会被程序忽略 #然后剩余非空白内容程序逐行读取，对于一个选项，其参数应当在下一行出现 #下面将设置输出文件名格式 --file-pattern <videoTitle>[<dfn>] #下面设置下载多个分P时，每个分P的下载间隔为2秒 --delay-per-page 2 #开启弹幕下载功能 --download-danmaku写一次配置，以后每条命令都自动生效，命令行党狂喜。
❓ 常见问题快速排查
Q1：提示找不到 ffmpeg？没有安装，或安装后没重启终端。可用--ffmpeg-path手动指定路径。
Q2：下载失败 / 需要会员内容？使用BBDown login扫码登录网页账号，或用-c "SESSDATA=..."手动传入 Cookie，详见 README.md 中的"WEB/TV鉴权"章节。
Q3：如何只解析不下载？加-info参数，例如BBDown -info "<url>"，可先看清有哪些清晰度和分 P 再决定。
Q4：分 P 太多显示不全？加--show-all展示全部分 P 标题。
🎯 小结
整个上手流程其实就三步：安装 BBDown → 安装 ffmpeg → 运行BBDown "<视频地址>"。从输入第一条命令到拿到 MP4 文件，熟练后 3 分钟绰绰有余。更多进阶玩法（番剧全集、自定义文件名变量、API 服务器模式等），欢迎继续翻阅项目文档 README.md 深入了解。
【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
