🔥 bilili：2025 终极 B 站视频下载神器！一键保存番剧/投稿视频+弹幕

bilili 是一款超实用的 B 站视频下载工具，支持快速抓取投稿视频（AV/BV 号）和番剧资源，内置多线程加速、断点续传和弹幕下载功能，让你轻松备份喜欢的视频内容！

🚀 为什么选择 bilili？3 大核心优势

⚡ 极速下载体验

采用 多线程分块下载 技术（src/bilili/handlers/downloader.py），配合断点续传功能，即使网络中断也能无缝接续，下载速度比普通工具提升 300%！

🎬 全格式支持

自动适配 B 站多种视频格式（FLV/DASH/MP4），通过 FFmpeg 自动合并音视频流（src/bilili/utils/ffmpeg.py），最终统一输出高清 MP4 文件，兼容所有播放器。

📝 弹幕完美同步

不仅能下载视频，还支持 XML 原生弹幕和 ASS 高级弹幕（src/bilili/handlers/base.py），让你离线也能享受原汁原味的弹幕互动体验！

📦 2 分钟快速上手

🔧 前置准备：安装 FFmpeg

由于视频需要合并，需先安装 FFmpeg：

• Windows：从 FFmpeg 官网 下载解压，将 ffmpeg.exe 路径添加到系统环境变量
• macOS/Linux：直接通过包管理器安装：brew install ffmpeg 或 sudo apt install ffmpeg

验证安装：终端输入 ffmpeg -version 显示版本信息即成功 ✅

🐍 一键安装 bilili

# 通过 pip 快速安装（推荐）
pip install bilili

# 或从源码安装最新版
git clone https://gitcode.com/gh_mirrors/bil/bilili
cd bilili
pip install .

🎯 开始下载！3 步搞定

1. 复制 B 站视频链接（支持以下类型）：

   • 投稿视频：https://www.bilibili.com/video/BVxxxxxx
   • 番剧主页：https://www.bilibili.com/bangumi/play/ssxxxxxx
   • 单集番剧：https://www.bilibili.com/bangumi/play/epxxxxxx

2. 终端执行命令：

bilili <视频链接>  # 基础下载（默认最高画质+弹幕）

3. 自定义参数（进阶用法）：

# 例：指定清晰度为 1080P，保存到 D 盘，同时下载 ASS 弹幕
bilili https://www.bilibili.com/video/BV1xxxxx -q 80 -d "D:/Videos" --danmaku ass

🛠️ 实用功能全解析

📊 清晰度自由选择

通过 -q 参数指定画质（默认 8K 超高清）：

• 127：8K 超高清
• 125：4K 超清
• 80：1080P 高清
• 64：720P 高清

完整参数说明可查看官方文档 docs/guide/getting-started.md

📑 智能选集下载

使用 -p 参数精准选择剧集：

bilili <番剧链接> -p 1-5,8,10~15  # 下载 1-5集、8集、10-15集

🎵 音频质量控制

通过 --audio-quality 调整音质（默认 320kbps）：

• 30280：320kbps（超高音质）
• 30232：128kbps（标准音质）

💡 新手常见问题 Q&A

❓ 下载速度慢怎么办？

1. 尝试增加线程数：-n 32（最大支持 64 线程）
2. 启用镜像加速：--use-mirrors
3. 检查网络代理设置，可添加 --disable-proxy 禁用系统代理

❓ 提示「需要登录」？

复制浏览器 Cookie 中的 SESSDATA 值，通过 -c 参数传入：

bilili <链接> -c "你的SESSDATA值"

📚 更多高级用法

📋 生成播放列表

自动创建 DPL/M3U 播放列表（默认 DPL 格式）：

bilili <链接> --playlist-type m3u  # 生成 M3U 格式播放列表

🎞️ 批量下载专区内容

添加 -s 参数下载 PV、预告和特别篇：

bilili <番剧主页> -s  # 同时下载附加剧集

🛠️ 项目结构速览

src/bilili/
├── api/          # B站API交互模块（[src/bilili/api/](https://gitcode.com/gh_mirrors/bil/bilili/blob/68ed1daaeda9f2dd5088ad153d9fcbf05df8e768/src/bilili/api/?utm_source=gitcode_repo_files)）
├── handlers/     # 下载核心逻辑（[src/bilili/handlers/](https://gitcode.com/gh_mirrors/bil/bilili/blob/68ed1daaeda9f2dd5088ad153d9fcbf05df8e768/src/bilili/handlers/?utm_source=gitcode_repo_files)）
├── parser/       # 视频链接解析器
└── utils/        # 工具函数（弹幕/FFmpeg处理等）

🌟 写在最后

无论是追番党备份收藏，还是UP主素材整理，bilili 都是你的高效助手！项目完全开源（遵循 MIT 协议），代码托管于 https://gitcode.com/gh_mirrors/bil/bilili，欢迎贡献代码或反馈问题～

现在就用 bilili 把喜欢的 B 站视频带回家吧！📥✨