BBDown：免费高效的B站视频下载完整指南
【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown
想要轻松收藏B站的精彩视频吗？无论你是想保存喜欢的UP主作品、备份学习资料，还是珍藏珍贵的番剧回忆，BBDown都能帮你实现。这款免费、高效、功能强大的命令行下载工具，让你轻松掌握B站视频下载的艺术。
🎯 为什么选择BBDown？
BBDown是一款专为B站用户设计的视频下载工具，它拥有许多独特优势：
完全免费开源- 无需付费，没有广告，所有功能免费使用多平台支持- 支持Windows、macOS、Linux系统高清画质- 最高支持8K超高清、HDR真彩、杜比视界智能解析- 支持普通视频、番剧、课程、收藏夹等多种内容类型灵活定制- 丰富的配置选项满足个性化需求
🚀 快速安装与上手
环境准备
BBDown基于.NET平台开发，安装前需要确保系统已安装.NET 6.0或更高版本。安装完成后，你就可以在任何命令行终端中使用BBDown了。
一键安装
安装BBDown非常简单，只需一行命令：
dotnet tool install --global BBDown如果需要更新到最新版本，运行：
dotnet tool update --global BBDown验证安装
安装完成后，输入以下命令验证是否安装成功：
BBDown --version看到版本号信息就说明安装成功，可以开始你的下载之旅了！
📱 基础使用：三步下载任意视频
第一步：复制视频链接
在B站找到你想要下载的视频，复制视频地址。可以是普通视频、番剧、课程等各种类型。
第二步：运行下载命令
打开命令行工具，输入最简单的下载命令：
BBDown "视频链接"例如：
BBDown "https://www.bilibili.com/video/BV1qt4y1X7TW"第三步：等待完成
BBDown会自动解析视频信息，选择最佳画质，并开始下载。下载完成后，视频文件会保存在当前目录下。
🌟 特色功能场景
无水印下载体验
想要下载无水印的视频？使用TV接口模式：
BBDown -tv "视频链接"TV接口通常提供无水印视频源，特别适合收藏高质量内容。
智能分P管理
对于多分P的视频，BBDown提供了灵活的下载选项：
# 下载单个分P BBDown -p 5 "视频链接" # 下载多个分P BBDown -p 1,3,5 "视频链接" # 下载分P范围 BBDown -p 1-10 "视频链接" # 下载所有分P BBDown -p ALL "视频链接"交互式清晰度选择
不确定选择哪个画质？让BBDown帮你选择：
BBDown -ia "视频链接"这个命令会显示所有可用的清晰度选项，让你交互式选择最适合的画质。
账号登录与会员内容
要下载会员专享内容，需要先登录B站账号：
# 扫码登录网页账号 BBDown login # 扫码登录TV账号 BBDown logintv登录信息会自动保存在本地，后续使用无需重复登录。
⚙️ 个性化配置与高级技巧
配置文件管理
创建配置文件可以永久保存你的个性化设置。在程序同目录下创建BBDown.config文件：
# 自定义单P文件名格式 --file-pattern <ownerName> - <videoTitle> [<dfn>_<res>] # 自定义多P文件夹结构 --multi-file-pattern <videoTitle>/[P<pageNumberWithZero>] <pageTitle> [<dfn>] # 开启弹幕下载 --download-danmaku # 设置分P下载间隔（秒） --delay-per-page 3 # 编码优先级设置 --encoding-priority hevc,av1,avc # 画质优先级设置 --dfn-priority 8K 超高清,杜比视界,HDR 真彩,4K 超清文件名变量详解
BBDown提供了丰富的变量供你自定义文件名：
| 变量名 | 说明 | 示例 |
|---|---|---|
<videoTitle> | 视频主标题 | "科技前沿" |
<pageNumber> | 分P序号 | "1" |
<pageNumberWithZero> | 补零分P序号 | "01" |
<pageTitle> | 分P标题 | "第一集" |
<bvid> | 视频BV号 | "BV1qt4y1X7TW" |
<dfn> | 视频清晰度 | "1080P 高清" |
<res> | 视频分辨率 | "1920x1080" |
<ownerName> | UP主名称 | "科技UP主" |
批量下载管理
BBDown支持多种批量下载场景：
收藏夹批量下载：
# 下载整个收藏夹 BBDown "收藏夹链接" # 设置批量下载间隔 BBDown --delay-per-page 5 "收藏夹链接"UP主空间视频批量下载：
# 下载UP主所有视频 BBDown "UP主空间链接"下载优化配置
多线程加速下载：
# 启用多线程下载（默认开启） BBDown -mt "视频链接"使用aria2c加速：
# 调用aria2c进行下载 BBDown -aria2 "视频链接"仅下载特定内容：
# 仅下载视频 BBDown --video-only "视频链接" # 仅下载音频 BBDown --audio-only "视频链接" # 仅下载字幕 BBDown --sub-only "视频链接" # 仅下载弹幕 BBDown --danmaku-only "视频链接"🔧 服务器模式部署
BBDown还支持API服务器模式，可以部署为独立的下载服务：
# 启动API服务器 BBDown serve -l http://0.0.0.0:12450服务器模式支持以下API功能：
- 获取任务列表
- 添加下载任务
- 查询任务状态
- 管理下载队列
你可以通过HTTP请求来管理下载任务，非常适合自动化脚本和批量处理。
💡 实用技巧与小贴士
快速获取视频信息
在不下载的情况下查看视频信息：
BBDown -info "视频链接"自定义下载目录
设置工作目录，避免文件散乱：
BBDown --work-dir "/path/to/download" "视频链接"跳过重复下载
记录已下载视频，避免重复下载：
BBDown --save-archives-to-file "视频链接"调试模式
遇到问题时启用调试模式：
BBDown --debug "视频链接"🛠️ 常见问题解决方案
安装问题
问题：提示.NET环境错误解决方案：确保安装了.NET 6.0或更高版本。Windows用户可以从微软官网下载，Linux用户可以使用包管理器安装。
问题：混流工具缺失解决方案：BBDown需要ffmpeg或mp4box进行音视频混流。请确保系统中已安装这些工具。
下载问题
问题：视频无法下载或解析失败解决方案：
- 检查网络连接和代理设置
- 尝试切换API接口模式（Web/TV/App）
- 更新到最新版本的BBDown
- 检查账号登录状态和权限
问题：下载速度慢解决方案：
- 启用多线程下载：
BBDown -mt - 使用aria2c加速：
BBDown -aria2 - 检查网络环境，尝试更换网络
📚 深入学习与进阶
技术架构概览
BBDown采用模块化设计，主要功能模块包括：
解析器模块- 负责解析B站的各种视频链接和API响应下载器模块- 实现多线程下载和进度显示混流器模块- 负责将视频、音频、字幕合并配置管理- 管理用户配置和程序设置
支持的视频类型
BBDown支持下载几乎所有类型的B站内容：
- 普通视频（Web/TV/App接口）
- 番剧全集（包括会员专享）
- 课程视频
- 合集、列表、收藏夹
- 个人空间视频
🎯 下一步行动建议
给新手的建议
- 从简单的单视频下载开始练习
- 创建自己的配置文件模板
- 尝试不同的API接口模式
- 学习使用基础命令参数
给进阶用户的建议
- 探索批量下载和自动化脚本
- 部署API服务器模式
- 研究配置文件系统
- 创建个性化的下载工作流
给开发者的建议
- 阅读核心源码了解实现原理
- 学习API服务器实现
- 参与社区讨论，分享使用经验
- 贡献代码或提交改进建议
🎉 开始你的B站视频收藏之旅
BBDown作为一款功能全面、免费高效的B站视频下载工具，无论是对于普通用户还是技术爱好者，都是一个不可多得的利器。通过本文的介绍，相信你已经掌握了BBDown的核心用法和高级技巧。
现在就开始打造你的专属B站高清视频收藏馆吧！无论是收藏经典番剧、保存学习资料，还是备份珍贵回忆，BBDown都能成为你的得力助手。
记住，合理使用，尊重原创，享受科技带来的便利！如果你在使用过程中遇到任何问题，可以参考项目文档或寻求社区帮助。祝您下载愉快！
核心源码参考：BBDown.Core/配置文件示例：BBDown.configAPI文档参考：json-api-doc.md
【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
